---
title: "Referencia de la API"
canonical: "https://docs.holnix.com/space/HW/388661281/Referencia%20de%20la%20API"
format: markdown
---
La **Referencia de la API** de Holnix describe en detalle cada uno de los endpoints disponibles, sus parámetros, métodos HTTP, y las respuestas que devuelve. Esta sección está diseñada para desarrolladores que buscan comprender cómo interactuar con la API y aprovechar al máximo sus funcionalidades.
## **Estructura de la Referencia**
### **Endpoint **/imprint/{imprint}
- **Descripción**: Lista todos los ISBNs asociados a una editorial específica.
- **Método**: GET
- **Parámetros**:
- imprint (path): Nombre de la editorial (obligatorio).
- language (query, opcional): Código de idioma ONIX (3 caracteres, e.g., eng).
#### **Ejemplo de solicitud**:
```
curl -X GET "https://api.holnix.com/api/imprint/EDITORIAL_NAME?language=LANG" \
-H "Authorization: Bearer YOUR_TOKEN"
```
#### **Respuesta exitosa (**200**)**:
```json
[
{
"_id": "668e39a81c6fe04ca70c2817",
"RecordReference": "9780789918659",
"NotificationType": "03",
"ProductIdentifier": [
{
"ProductIDType": "15",
"IDValue": "9780789918659"
},
{
"ProductIDType": "01",
"IDTypeName": "ONIX_NOSEQ",
"IDValue": "e7499ebc-3d33-4690-bdbd-b326cd621add"
},
{
"ProductIDType": "03",
"IDValue": "9780789918659"
},
{
"ProductIDType": "02",
"IDValue": "078991865X"
}
],.........
```
### **Variables disponibles para editoriales: Endpoint **/imprints
- **Descripción**: Lista todos las editoriales disponibles
- **Método**: GET
#### **Ejemplo de solicitud**:
```
curl -X GET "https://api.holnix.com/api/imprints" \
-H "Authorization: Bearer YOUR_TOKEN"
```
#### **Respuesta exitosa (**200**)**:
```json
[
{
"_id": {
"slug": "amacom"
},
"slug": "amacom",
"name": "AMACOM"
},
{
"_id": {
"slug": "applesauce-press"
},
"slug": "applesauce-press",
"name": "Applesauce Press"
},
{
"_id": {
"slug": "aspire-press"
},
"slug": "aspire-press",
"name": "Aspire Press"
},........
]
```
#### Variables disponibles por idioma
> ℹ️ **spa** > Español
> ℹ️
> ℹ️ **eng** > Inglés
Los 2 idiomas listados son los más comunes del catálogo, pero el endpoint acepta cualquier código de 3 caracteres que represente el idioma en el estándar ONIX 3.
#### **Errores comunes**:
- 404 Imprint not found: La editorial especificada no existe.
### **Endpoint **/isbn/{isbn}
- **Descripción**: Recupera los metadatos de un único ISBN.
- **Método**: GET
- **Parámetros**:
- isbn (path): ISBN del libro (obligatorio).
#### **Ejemplo de solicitud**:
```
curl -X GET "https://api.holnix.com/api/isbn/9780789928184" \
-H "Authorization: Bearer YOUR_TOKEN"
```
#### **Respuesta exitosa (**200**)**:
```json
{
"_id": "668e39c21c6fe04ca70c2b4f",
"RecordReference": "9780789928184",
"NotificationType": "03",
"ProductIdentifier": [
{
"ProductIDType": "03",
"IDValue": "9780789928184"
},
{
"ProductIDType": "15",
"IDValue": "9780789928184"
},
{
"ProductIDType": "01",
"IDTypeName": "ONIX_NOSEQ",
"IDValue": "0247c620-0526-4a01-88f9-b49680096cb0"
}
],
"DescriptiveDetail": {
"ProductComposition": "00",
"ProductForm": "BC",
"ProductFormDetail": "B102",
"ProductPackaging": "21",
"PrimaryContentType": "10",
"Measure": [
{
"MeasureType": "01",
"Measurement": "6.62",
"MeasureUnitCode": "in"
},
{
"MeasureType": "02",
"Measurement": "4.25",
"MeasureUnitCode": "in"
},
{
"MeasureType": "03",
"Measurement": "0.15",
"MeasureUnitCode": "in"
},
{
"MeasureType": "08",
"Measurement": "1",
"MeasureUnitCode": "lb"
}
],
"CountryOfManufacture": "CO",
"NoCollection": [],
"TitleDetail": {
"TitleType": "01",
"TitleElement": {
"TitleElementLevel": "01",
"TitleText": "Serie Grandes Preguntas 2: ¿Por qué Dios permite que sucedan cosas malas?"
}
},........
```
**Errores comunes**:
- 404 Book not found: El ISBN especificado no existe.
### **Endpoint **/isbns/{isbns}
- **Descripción**: Recupera los metadatos de múltiples ISBNs separados por comas.
- **Método**: GET
- **Parámetros**:
- isbns (path): Lista de ISBNs separados por comas (obligatorio).
#### **Ejemplo de solicitud**:
```
curl -X GET "https://api.holnix.com/api/isbns/9780789928207,9780789928184" \
-H "Authorization: Bearer YOUR_TOKEN"
```
#### **Respuesta exitosa (**200**)**:
```json
[
{
"_id": "668e39c21c6fe04ca70c2b4f",
"RecordReference": "9780789928184",
"NotificationType": "03",
"ProductIdentifier": [
{
"ProductIDType": "03",
"IDValue": "9780789928184"
},
{
"ProductIDType": "15",
"IDValue": "9780789928184"
},
{
"ProductIDType": "01",
"IDTypeName": "ONIX_NOSEQ",
"IDValue": "0247c620-0526-4a01-88f9-b49680096cb0"
}
],
"DescriptiveDetail": {
"ProductComposition": "00",
"ProductForm": "BC",
"ProductFormDetail": "B102",
"ProductPackaging": "21",
"PrimaryContentType": "10",
"Measure": [
{
"MeasureType": "01",
"Measurement": "6.62",
"MeasureUnitCode": "in"
},
{
"MeasureType": "02",
"Measurement": "4.25",
"MeasureUnitCode": "in"
},
{
"MeasureType": "03",
"Measurement": "0.15",
"MeasureUnitCode": "in"
},
{
"MeasureType": "08",
"Measurement": "1",
"MeasureUnitCode": "lb"
}
],
"CountryOfManufacture": "CO",
"NoCollection": [],
"TitleDetail": {
"TitleType": "01",
"TitleElement": {
"TitleElementLevel": "01",
"TitleText": "Serie Grandes Preguntas 2: ¿Por qué Dios permite que sucedan cosas malas?"
}
},
"Contributor": {
"SequenceNumber": "1",
"ContributorRole": "A01",
"PersonName": "Chris Morphew",
"PersonNameInverted": "Morphew, Chris",
"NamesBeforeKey": "Chris",
"KeyNames": "Morphew"
},
"NoEdition": [],
"Language": {
"LanguageRole": "01",
"LanguageCode": "spa"
},
"Extent": {
"ExtentType": "00",
"ExtentValue": "96",
"ExtentUnit": "03"
},
"Subject": [
{
"MainSubject": [],
"SubjectSchemeIdentifier": "12",
"SubjectCode": "HRC",
"SubjectHeadingText": "cristiandad"
},
{
"MainSubject": [],
"SubjectSchemeIdentifier": "10",
"SubjectCode": "REL091000",
"SubjectHeadingText": "RELIGIÓN / Educación Cristiana / Niños y Jóvenes"
},
{
"MainSubject": [],
"SubjectSchemeIdentifier": "11",
"SubjectCode": "4.0.1.0.0.0.0",
"SubjectHeadingText": "USA"
},
{
"MainSubject": [],
"SubjectSchemeIdentifier": "93",
"SubjectCode": "QRMP",
"SubjectHeadingText": "Vida y práctica cristianas"
}
],
"Audience": {
"AudienceCodeType": "01",
"AudienceCodeValue": "01"
},
"AudienceRange": {
"AudienceRangeQualifier": "17",
"AudienceRangePrecision": [
"03",
"04"
],
"AudienceRangeValue": [
"9",
"12"
]
}
},
"CollateralDetail": {
"TextContent": [
{
"TextType": "03",
"ContentAudience": "00",
"Text": "Edad sugerida: 9-13 años
\n\n
Los preadolescentes tienen grandes preguntas sobre Dios, la vida, la fe y la Biblia. Una común es: ¿Por qué Dios permite que nos pasen cosas malas?
\nLas grandes preguntas merecen buenas respuestas. Este libro cálido, reconfortante y dinámico examina lo que dice la Biblia para ayudar a los jovencitos a reflexionar sobre esta gran pregunta por sí mismos. \n
\n
\n
Este segundo libro de una serie caracterizada por su tono amable y empático sitúa el problema del sufrimiento en el contexto de la gran historia de la Biblia y anima a los jóvenes lectores a ver que, sea cual sea el desafío que enfrenten, Jesús está con ellos.
\n\n
Los capítulos de ¿Por qué Dios permite que sucedan cosas malas? son cortos y su información concisa. Es fácil de entender por su lenguaje contemporáneo y apropiado para la Generación Alfa (nacidos de 2010 en adelante) y por las historias animadas e ilustraciones incluidas.
\n
\n
\n
El libro está diseñado en un tamaño portátil para que sea fácil de manejar y de llevar a cualquier parte. \n
\n
\n
Ideal también para padres, pastores, consejeros o líderes de jóvenes, adolescentes y niños.
"
},
{
"TextType": "12",
"ContentAudience": "00",
"Text": "Es autor, profesor y capellán escolar que vive en Sídney, Australia
"
}
],........
```
**Errores comunes**:
- 404 Book not found: Uno o más ISBNs no existen.
### **Endpoint **/news
- **Descripción**: Lista los títulos publicados a partir de una fecha específica.
- **Método**: GET
- **Parámetros**:
- date (query, opcional): Fecha en formato YYYYMMDD. Si no se proporciona, devuelve todos los títulos recientes de los últimos 90 días.
#### **Ejemplo de solicitud**:
```
curl -X GET "https://api.holnix.com/api/news?date=20241201" \
-H "Authorization: Bearer YOUR_TOKEN"
```
#### **Respuesta exitosa (**200**)**:
```json
[
{
"_id": "66c830abbfe0172d14070c47",
"RecordReference": "9780789926937",
"NotificationType": "03",
"ProductIdentifier": [
{
"ProductIDType": "01",
"IDTypeName": "ONIX_NOSEQ",
"IDValue": "6bb88983-85d7-4c89-992a-4dcb8e27eb12"
},
{
"ProductIDType": "03",
"IDValue": "9780789926937"
},
{
"ProductIDType": "15",
"IDValue": "9780789926937"
}
],
"DescriptiveDetail": {
"ProductComposition": "00",
"ProductForm": "BB",
"ProductFormDetail": "P201",
"ProductPackaging": "21",
"PrimaryContentType": "10",
"Measure": [
{
"MeasureType": "01",
"Measurement": "8",
"MeasureUnitCode": "in"
},
{
"MeasureType": "02",
"Measurement": "5",
"MeasureUnitCode": "in"
},
{
"MeasureType": "03",
"Measurement": "1",
"MeasureUnitCode": "in"
},
{
"MeasureType": "08",
"Measurement": "16.19",
"MeasureUnitCode": "kg"
}
],
"CountryOfManufacture": "CN",
"NoCollection": [],
"TitleDetail": {
"TitleType": "01",
"TitleElement": {
"TitleElementLevel": "01",
"TitleText": "Biblia de Promesas para niñas Reina Valera - 1960"
}
},
"Contributor": {
"SequenceNumber": "1",
"ContributorRole": "B01",
"CorporateName": "Editorial Unilit"
},
```
**Errores comunes**:
- 400 Invalid date format: El formato de fecha enviado es incorrecto.
### **Endpoint **/skus
- **Descripción**: Lista todos los ISBNs del catálogo
- **Método**: GET
#### **Ejemplo de solicitud**:
```
curl -X GET "https://api.holnix.com/api/skus" \
-H "Authorization: Bearer YOUR_TOKEN"
```
### **Endpoint **/translations
- **Descripción**: Lista todas las traducciones disponibles de los atributos correspondientes
- **Método**: GET
#### **Ejemplo de solicitud**:
```
curl -X GET "https://api.holnix.com/api/translations" \
-H "Authorization: Bearer YOUR_TOKEN"
```
#### **Respuesta exitosa (**200**)**:
```json
{
"_id": {
"$oid": "670d1e62dc2364a80bb92321"
},
"product_forms": {
"00": {
"eng": "Undefined",
"spa": "No definido"
},
"AA": {
"eng": "Audio",
"spa": "Audio"
},
"AB": {
"eng": "Audiocassette",
"spa": "Audiocasete"
},.......
},
"languages": {
"eng": {
"eng": "English",
"spa": "Inglés"
},
"spa": {
"eng": "Spanish",
"spa": "Español"
},
"fra": {
"eng": "French",
"spa": "Francés"
},......
},
"publishing_status": {
"00": {
"eng": "Unspecified",
"spa": "No especificado"
},
"01": {
"eng": "Cancelled",
"spa": "Cancelado"
},
"02": {
"eng": "Forthcoming",
"spa": "Próxima aparición"
},.......
},
"product_availability": {
"01": {
"eng": "Cancelled",
"spa": "Cancelado"
},
"09": {
"eng": "Not yet available, postponed indefinitely",
"spa": "No disponible todavía, pospuesto indefinidamente"
},
"10": {
"eng": "Not yet available",
"spa": "No disponible todavía"
},.......
}
}
```
### **Notas finales**
- Asegúrate de incluir siempre el token JWT en el encabezado de las solicitudes.
- Consulta los ejemplos prácticos en la sección **“Guía de Inicio”** para implementar estos endpoints en tu proyecto.
Con esta referencia, podrás explorar todos los datos y funcionalidades que ofrece la API de Holnix de manera eficiente y confiable.