---
title: "Guía de inicio"
canonical: "https://docs.holnix.com/space/HW/387383405/Gu%C3%ADa%20de%20inicio"
format: markdown
---
La **Guía de inicio** está diseñada para ayudarte a comenzar rápidamente con la integración y el uso de la API de Holnix. Aquí encontrarás los pasos básicos para autenticarte, realizar tu primera consulta y explorar las funcionalidades principales.
## Requisitos Previos
Antes de comenzar, asegúrate de contar con lo siguiente:
1. **Acceso a un token de autorización**:
- Contacta con nuestro equipo de soporte para obtener tu token JWT. Este token es necesario para autenticar todas las solicitudes a la API.
2. **Entorno de pruebas interactivo**:
- Acceso a para explorar y probar los endpoints.
[https://api.holnix.com/openapi.html#/](https://api.holnix.com/openapi.html#/)
3. **Herramienta para realizar solicitudes HTTP**:
- Recomendaciones: [Postman](https://www.postman.com/), [cURL](https://curl.se/), o cualquier biblioteca HTTP en tu lenguaje de programación preferido (e.g., axios en JavaScript o requests en Python).
## Configuración Inicial
Sigue estos pasos para realizar tu primera solicitud a la API:
1. **Obtener tu token JWT**:
- Asegúrate de tener un token válido. Si no dispones de uno, consulta la sección de autenticación en esta documentación.
2. **Realizar una petición básica**:
Utilizando tu herramienta preferida, realiza una solicitud HTTP a uno de los endpoints disponibles. Aquí tienes un ejemplo con cURL:
```
curl -X GET "https://api.holnix.com/api/isbn/9781234567890" \\
-H "Authorization: Bearer YOUR_TOKEN"
```
3. **Explorar los endpoints**:
- Usa el entorno OpenAPI para probar cada endpoint y entender qué datos puedes consultar.
- Ejemplo: Realiza una consulta para listar los libros de una editorial específica en /api/imprint/{imprint}.
## Estructura de las Respuestas
Todas las respuestas de la API se devuelven en formato JSON, estructuradas según el estándar ONIX 3. Aquí tienes un ejemplo básico de una respuesta para un libro consultado por ISBN:
```json
{
"_id": "668e39c21c6fe04ca70c2b51",
"RecordReference": "9780789928405",
"NotificationType": "03",
"ProductIdentifier": [
{
"ProductIDType": "03",
"IDValue": "9780789928405"
},
{
"ProductIDType": "15",
"IDValue": "9780789928405"
},
{
"ProductIDType": "01",
"IDTypeName": "ONIX_NOSEQ",
"IDValue": "dc13adee-8c48-460e-a2b5-bc9a0341d466"
}
],
"DescriptiveDetail": {
"ProductComposition": "00",
"ProductForm": "BC",
"ProductFormDetail": "B102",
"ProductPackaging": "21",
"PrimaryContentType": "10",
"Measure": [
{
"MeasureType": "01",
"Measurement": "9.45",
"MeasureUnitCode": "in"
},
{
"MeasureType": "02",
"Measurement": "6.50",
"MeasureUnitCode": "in"
},
{
"MeasureType": "03",
"Measurement": "0.19",
"MeasureUnitCode": "in"
},
{
"MeasureType": "08",
"Measurement": "1",
"MeasureUnitCode": "lb"
}
],
"CountryOfManufacture": "CO",
"NoCollection": [],
"TitleDetail": {
"TitleType": "01",
"TitleElement": {
"TitleElementLevel": "01",
"TitleText": "Los 5 lenguajes del amor para hombres - Cuaderno de ejercicios"
}
},
"Contributor": {
"SequenceNumber": "1",
"ContributorRole": "A01",
"PersonName": "Gary Chapman",
"PersonNameInverted": "Chapman, Gary",
"NamesBeforeKey": "Gary",
"KeyNames": "Chapman"
},
"NoEdition": [],
"Language": {
"LanguageRole": "01",
"LanguageCode": "spa"
},
"Extent": {
"ExtentType": "00",
"ExtentValue": "112",
"ExtentUnit": "03"
},
"Subject": [
{
"MainSubject": [],
"SubjectSchemeIdentifier": "12",
"SubjectCode": "HRC",
"SubjectHeadingText": "cristiandad"
},
{
"MainSubject": [],
"SubjectSchemeIdentifier": "10",
"SubjectCode": "REL012070",
"SubjectHeadingText": "RELIGIÓN / vida cristiana / Crecimiento personal"
},
{
"MainSubject": [],
"SubjectSchemeIdentifier": "11",
"SubjectCode": "4.0.1.0.0.0.0",
"SubjectHeadingText": "USA"
},
{
"MainSubject": [],
"SubjectSchemeIdentifier": "93",
"SubjectCode": "QRM",
"SubjectHeadingText": "Cristianismo"
},
{
"SubjectSchemeIdentifier": "20",
"SubjectHeadingText": "lenguajes, amor, cariño, hombres, enseñanza, aprender, expresar"
}
],
"Audience": {
"AudienceCodeType": "01",
"AudienceCodeValue": "01"
},
"AudienceRange": {
"AudienceRangeQualifier": "17",
"AudienceRangePrecision": "03",
"AudienceRangeValue": "18"
}
},
"CollateralDetail": {
"TextContent": [
{
"TextType": "12",
"ContentAudience": "00",
"Text": "Autor, conferenciante y consejero, siente pasión por ayudar a las personas a entablar relaciones duraderas.
Es el autor número uno de la serie de superventas «Los 5 lenguajes del amor» y el director de Marriage and Family Life Consultants, Inc. Gary viaja por todo el mundo presentando seminarios, y sus programas de radio se transmiten por más de cuatrocientas emisoras. Para más información, visita www.5lenguajesdelamor.com
"
},
{
"TextType": "03",
"ContentAudience": "00",
"Text": "Los buenos matrimonios no surgen de la nada. Requieren esfuerzo.
\nLas diez lecciones de este cuaderno fueron creadas para fortalecer y profundizar tu relación con tu ser amado. Estas lecciones te brindan estrategias viables para aplicar los principios de Los 5 Lenguajes del Amor® para hombres. Te ofrecen vislumbres del potencial de tu relación cuando tú y tu pareja hablan el lenguaje del amor del otro.
\nYa sea que estés trabajando con este libro como individuo, en pareja o en un grupo pequeño, deja que la paciencia, la gracia y el humor sean tus compañeros. Aprender un nuevo lenguaje del amor puede ser difícil, e implica un poco de prueba y error.
\nEsto no será particularmente fácil. Nada que valga la pena lo es. Pero verás dividendos. Y cuanto más de ti mismo inviertas en este cuaderno de trabajo, mayores serán tus dividendos.
"
}
],
"SupportingResource": {
"ResourceContentType": "01",
"ContentAudience": "00",
"ResourceMode": "03",
"ResourceFeature": {
"ResourceFeatureType": "02",
"FeatureNote": "portada.jpeg"
},
"ResourceVersion": {
"ResourceForm": "01",
"ResourceVersionFeature": [
{
"ResourceVersionFeatureType": "01",
"FeatureValue": "D502"
},
{
"ResourceVersionFeatureType": "02",
"FeatureValue": "772"
},
{
"ResourceVersionFeatureType": "03",
"FeatureValue": "531"
},
{
"ResourceVersionFeatureType": "04",
"FeatureValue": "portada.jpeg"
},
{
"ResourceVersionFeatureType": "05",
"FeatureValue": "0.16"
}
],
"ResourceLink": "https://www.editorialunilit.com/media/catalog/product/p/o/portada.jpeg",
"ContentDate": {
"ContentDateRole": "17",
"Date": "20240726T0012"
}
}
}
},
"PublishingDetail": {
"Imprint": {
"ImprintName": "Editorial Unilit"
},
"Publisher": {
"PublishingRole": "01",
"PublisherName": "Editorial Unilit",
"Website": {
"WebsiteRole": "01",
"WebsiteLink": "https://www.editorialunilit.com"
}
},
"CityOfPublication": "Miami",
"CountryOfPublication": "US",
"PublishingStatus": "04",
"PublishingDate": {
"PublishingDateRole": "01",
"Date": "20241115"
},
"SalesRights": {
"SalesRightsType": "01",
"Territory": {
"RegionsIncluded": "WORLD"
}
}
},
"RelatedMaterial": {
"RelatedProduct": {
"ProductRelationCode": "00",
"ProductIdentifier": {
"ProductIDType": "15",
"IDValue": "9780789928399"
},
"ProductForm": "BA"
}
},
"ProductSupply": {
"SupplyDetail": {
"Supplier": {
"SupplierRole": "01",
"SupplierName": "Editorial Unilit"
},
"ReturnsConditions": {
"ReturnsCodeType": "02",
"ReturnsCode": "C"
},
"ProductAvailability": "11",
"PackQuantity": "68",
"Price": {
"PriceType": "01",
"PriceAmount": "10.99",
"Tax": {
"TaxRateCode": "T",
"TaxAmount": "0"
},
"CurrencyCode": "USD",
"Territory": {
"CountriesIncluded": "US"
}
}
}
},
"updated_at": "2024-11-29T12:10:21.448000Z",
"created_at": "2024-07-10T07:35:30.720000Z",
"HolnixImages": {
"Thumbnail": "https://holnix.s3.eu-west-3.amazonaws.com/images/9780789928405_th.jpeg"
}
}
```
### **Probar la API**
Para facilitar el inicio, **Holnix** ofrece un entorno interactivo:
[https://api.holnix.com/openapi.html#/](https://api.holnix.com/openapi.html#/)
En este entorno, puedes realizar solicitudes en tiempo real y obtener respuestas directamente desde la API, lo que te ayudará a validar tu configuración y comprender los datos que puedes obtener.
### **Próximos Pasos**
1. Explora los endpoints disponibles en la sección de **Referencia de la API**.
2. Consulta la sección de **Esquema de Datos ONIX 3** para entender en detalle las propiedades de las respuestas.
3. Integra la API en tu aplicación utilizando ejemplos de código proporcionados en esta documentación.
Con estos pasos iniciales, estarás listo para aprovechar al máximo las capacidades de la API de Holnix.