---
title: "Pruebas interactivas"
canonical: "https://docs.holnix.com/space/HW/388530192/Pruebas%20interactivas"
format: markdown
---
La API de Holnix incluye una i**nterfaz interactiva basada en OpenAPI** que permite a los desarrolladores explorar y probar sus funcionalidades sin necesidad de implementar código de inmediato. Este entorno facilita la comprensión de los endpoints disponibles, sus parámetros y las respuestas que devuelve la API.

## **Acceso al entorno interactivo**

- **URL**:

[https://api.holnix.com/openapi.html#/](https://api.holnix.com/openapi.html#/)

- **Requisitos**:

Un token de autenticación válido. Este se debe incluir en el encabezado de las solicitudes durante las pruebas.

## **Características del entorno**

1. **Exploración visual de los endpoints**:

- Muestra todos los endpoints disponibles organizados por categorías.
- Cada endpoint incluye una descripción, los métodos soportados (GET, POST, etc.), y los parámetros esperados.

2. **Pruebas en tiempo real**:

- Permite enviar solicitudes directamente desde la interfaz, proporcionando los parámetros necesarios en un formulario fácil de usar.
- Muestra las respuestas de la API en formato JSON, lo que ayuda a validar los datos y a identificar posibles problemas.

3. **Autenticación simplificada**:

- Puedes agregar tu token JWT directamente en el campo de autorización para autenticar todas las solicitudes dentro del entorno.

4. **Documentación integrada**:

- Cada endpoint incluye detalles sobre:
- Parámetros requeridos y opcionales.
- Ejemplos de uso.
- Respuestas esperadas (con ejemplos y códigos de estado HTTP).

## **Cómo realizar tus primeras pruebas**

1. **Inicia sesión en el entorno interactivo**:

- Abre

[https://api.holnix.com/openapi.html#/](https://api.holnix.com/openapi.html#/)

- Introduce tu token JWT en el campo de autorización.

2. **Selecciona un endpoint**:

- Elige el endpoint que deseas probar, por ejemplo, /api/imprint/{imprint}.

3. **Configura los parámetros**:

- Completa los campos requeridos, como el nombre de la editorial en el caso de /imprint/{imprint} o un ISBN específico en /isbn/{isbn}.

4. **Envía la solicitud**:

- Haz clic en el botón “Try it out” para ejecutar la solicitud.
- Revisa la respuesta devuelta en la sección de resultados.

## **Ejemplo de prueba**

- Endpoint: GET /api/isbn/{isbn}
- Proceso:

1. Selecciona el endpoint en el entorno interactivo.
2. Introduce un ISBN válido, como 9780789928405.
3. Asegúrate de haber añadido tu token JWT en el encabezado de autorización.
4. Haz clic en “Execute”.
5. Resultado esperado:

```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"
        },.......
```

### **Errores comunes durante las pruebas**

1. **Falta el token JWT**:

- Mensaje de error: 401 Unauthorized.
- Solución: Asegúrate de ingresar tu token JWT en el campo de autorización del entorno.

2. **Parámetros inválidos**:

- Mensaje de error: 400 Bad Request.
- Solución: Revisa los valores ingresados en los campos de parámetros. Consulta las descripciones de cada uno en la interfaz.

3. **Endpoint incorrecto**:

- Mensaje de error: 404 Not Found.
- Solución: Verifica que la URL esté correctamente configurada.

### **Ventajas de las pruebas interactivas**

- Permiten validar configuraciones antes de implementarlas en código.
- Ayudan a familiarizarte con los datos y las funcionalidades de la API.
- Facilitan la depuración de problemas sin necesidad de desarrollar herramientas adicionales.

El entorno interactivo es una herramienta esencial para desarrollar con confianza, asegurando que tus integraciones con la API de Holnix sean rápidas, efectivas y libres de errores.