Basset Help

Menu
Cerrar
Support

Help Basset

API Asistencia

Descripción General

Este flujo cubre el proceso de obtención de información y reserva de seguros de viaje a través de diferentes APIs. El flujo consta de varios pasos organizados de la siguiente manera:

      1. Obtención de regiones de seguros (Autocomplete).
      2. Búsqueda de seguros disponibles.
      3. Confirmación de un seguro seleccionado.
      4. Creación de una reserva de seguro.
      5. Verificación del estado de la reserva.
      6. Consulta de información detallada de la reserva.

    Cada paso está respaldado por uno o más endpoints con detalles específicos de parámetros y respuestas.

    1. Autocomplete Regiones

    Endpoint:

    GET /catalog/travel-insurances-regions

    URL Completa: https://api.basset.ws/catalog/travel-insurances-regions?language=es

    Cabeceras Requeridas:

        • x-api-key: Tu clave de API.

        • x-client-id: Tu ID de cliente.

      Parámetros de Query:

          • language: Idioma de la respuesta (por ejemplo, es).

        Ejemplo de Respuesta:

        [
    {
        "id": "36831d79-6588-47b4-b5be-d117009bb89d",
        "name": "América del Sur",
        "type": "INTERNATIONAL"
    },
    ...
]

        2. Búsqueda de Seguros Disponibles

        Endpoint:

        GET /travel-insurances/search

        URL Completa: https://api.basset.ws/travel-insurances/search

        Cabeceras Requeridas:

            • x-api-key: Tu clave de API.

            • x-client-id: Tu ID de cliente.

          Parámetros de Query:

              • origin_region_id (requerido): ID de la región de origen.

              • destination_region_id (requerido): ID de la región de destino.

              • from y to (requeridos): Fechas de inicio y fin del viaje (formato YYYY-MM-DD).

              • ages (requerido): Edad(es) de los viajeros.

              • limit y offset (opcional): Paginación de resultados.

            Ejemplo de Respuesta:

            {
    "insurances": [
        {
            "id": "39db126c-c330-4d91-97a7-5e84dbfd5f46",
            "name": "AC 60",
            "provider": "ASSIST_CARD",
            "rate": {
                "total": 71760.57,
                "currency": "ARS"
            }
        },
        ...
    ]
}

            3. Confirmación de Seguro Seleccionado

            Endpoint:

            GET /travel-insurances/search/{insurance_id}

            URL Completa: https://api.basset.ws/travel-insurances/search/{insurance_id}

            Cabeceras Requeridas:

                • x-api-key: Tu clave de API.

                • x-client-id: Tu ID de cliente.

              Parámetros de Query:

                  • site y channel (opcional): Información del sitio y canal.

                Ejemplo de Respuesta:

                {
    "id": "39db126c-c330-4d91-97a7-5e84dbfd5f46",
    "name": "AC 60",
    "description": "Asistencia Médica USD 60K + Preexistencia USD 10K",
    "rate": {
        "total": 71760.57,
        "currency": "ARS"
    }
}

                4. Creación de Reserva

                Endpoint:

                POST /reservations/async

                URL Completa: https://api.basset.ws/reservations/async

                Cabeceras Requeridas:

                    • x-api-key: Tu clave de API.

                    • x-client-id: Tu ID de cliente.

                  Cuerpo de la Solicitud:

                  {
    "products": [
        {
            "item_id": "39db126c-c330-4d91-97a7-5e84dbfd5f46",
            "type": "TRAVEL_INSURANCE",
            "travel_insurances_passengers": [
                {
                    "firstname": "jorge",
                    "lastname": "sanchez",
                    "birth": "1992-10-05",
                    "document": {
                        "type": "PAS",
                        "number": "97345234"
                    }
                }
            ]
        }
    ],
    "contact": {
        "email": "jorge.sanchez@basset.la",
        "telephone": {
            "country_code": "54",
            "area_code": "011",
            "number": "87653443"
        }
    }
}

                  Ejemplo de Respuesta:

                  {
    "id": "ee82e49e-510f-4f4a-83c7-88695d977e24",
    "status": "BOOKING"
}

                  5. Verificación del Estado de la Reserva

                  Endpoint:

                  GET /reservations/process/{reservation_id}

                  URL Completa: https://api.basset.ws/reservations/process/{reservation_id}

                  Cabeceras Requeridas:

                      • x-api-key: Tu clave de API.

                      • x-client-id: Tu ID de cliente.

                    Ejemplo de Respuesta:

                    {
    "id": "ee82e49e-510f-4f4a-83c7-88695d977e24",
    "status": "OK",
    "reservation_id": "175237956"
}

                    6. Información Detallada de la Reserva

                    Endpoint:

                    GET /reservations/{reservation_id}

                    URL Completa: https://api.basset.ws/reservations/{reservation_id}

                    Cabeceras Requeridas:

                        • x-api-key: Tu clave de API.

                        • x-client-id: Tu ID de cliente.

                      Ejemplo de Respuesta:

                      {
    "id": "175237956",
    "products": [
        {
            "name": "AC 60",
            "status": "ISSUED",
            "rate": {
                "total": 71760.57,
                "currency": "ARS"
            }
        }
    ]
}

                      Errores Comunes

                          • 401 Unauthorized: La API key o el client ID no son válidos.

                          • 404 Not Found: La reserva o seguro solicitado no existe.

                          • 500 Internal Server Error: Problemas en el servidor.

                        Notas Finales

                        Acá esta colección de postman con ejemplos paso a paso.


                        Descargar colección completa