Skip to content

API Intermediarios (1.0.0)

Bienvenido al API de Intermediarios

El API de Intermediarios ha sido diseñado para que puedas acceder e integrar fácilmente las principales funcionalidades que ofrecemos a nuestros socios y aliados.

Con esta API podrás:

  • Cotizar productos de Salud, Generales y Vida
  • Emitir pólizas de manera digital
  • Consultar tus pólizas, facturas, consumos y más

Todo en un solo lugar, con seguridad, rapidez y disponibilidad 24/7.

¿Qué encontrarás en esta documentación?

En esta página encontrarás toda la información necesaria para comenzar a usar el API, incluyendo:

  • Descripción general del API
  • Especificación OpenAPI en formato YAML, lista para ser utilizada en Postman, Swagger u otras herramientas
  • Ejemplos prácticos de uso para integrarte más rápido
  • Guías paso a paso para autenticación, cotización, emisión y consulta de información

Primeros pasos

  1. Consulta la especificación OpenAPI
  2. Explora los endpoints disponibles en la sección de referencia
  3. Integra las funcionalidades en tus sistemas internos para comenzar a operar

Beneficios clave

🔄 Automatización

Automatización de procesos de cotización y emisión.

🔒 Seguridad

Seguridad con estándares modernos de autenticación.

⚡ Disponibilidad 24/7

Siempre tengas acceso a tu información.

📈 Escalabilidad

Lista para crecer con tus operaciones.

Download OpenAPI description
index.json
index.yaml
Overview
Equipo de APIs Humano Seguros
apis@humano.com.do
License
MIT
Languages
Servers
Mock server
https://intermediarios-api.humano.com.do/_mock/apis/
DEV API
https://devapi.humano.com.do/api/
Production API
https://huapi.humano.com.do/api/

Servicio de Pólizas

Endpoints para consultar información de tus pólizas

Operations

Servicio de Facturas

Endpoints para consultar información de facturas

Operations

Servicio de Comisiones

Endpoints para consultar comisiones generadas

Operations

Servicio de Cobros

Endpoints para consultar cobros e ingresos aplicados a pólizas

Operations

Servicio de Catálogos

Endpoints para consultar catálogos y datos de referencia

Operations

Servicio de Cotizaciones

Endpoints para gestionar cotizaciones

Operations

Servicio de Vehículos

Endpoints para consultar información de vehículos (marcas, modelos, versiones)

Operations

Obtener Modelos de Vehículos

Request

Obtiene el listado de modelos de automóviles elegibles según el código de plan y código de marca especificados.

Los modelos disponibles varían dependiendo del plan y la marca seleccionados.

Parámetros obligatorios: cdPlan y cdMarca son requeridos.

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Query
cdPlanintegerrequired

Código del plan:

  • 0 - Mi Auto Premier (Todo Riesgo Cero Deducible)
  • 1 - Mi Auto Full (Todo Riesgo Con Deducible)
  • 2 - Mi Auto Básico (Seguro de Ley)
  • 3 - Mi Auto Flex (Todo Riesgo Perdida Total)
  • 4 - Mi Moto Básico
Enum01234
Example: cdPlan=1
cdMarcaintegerrequired

Código de la marca de vehículo

Example: cdMarca=1
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/vehiculos/modelos?cdPlan=1&cdMarca=1' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY_HERE' \
  -H 'x-codigo-mediador: YOUR_API_KEY_HERE' \
  -H 'x-user-key: YOUR_API_KEY_HERE'

Responses

Consulta exitosa

Bodyapplication/json
payloadArray of objects(Modelo)
Response
application/json
{
  "payload": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}

Obtener Versiones de Vehículos

Request

Obtiene el listado de versiones de modelos de automóviles elegibles según el código de plan, código de marca y código de modelo especificados.

Las versiones disponibles varían dependiendo del plan, la marca y el modelo seleccionados.

Parámetros obligatorios: cdPlan, cdMarca y cdModelo son requeridos.

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Query
cdPlanintegerrequired

Código del plan:

  • 0 - Mi Auto Premier (Todo Riesgo Cero Deducible)
  • 1 - Mi Auto Full (Todo Riesgo Con Deducible)
  • 2 - Mi Auto Básico (Seguro de Ley)
  • 3 - Mi Auto Flex (Todo Riesgo Perdida Total)
  • 4 - Mi Moto Básico
Enum01234
Example: cdPlan=1
cdMarcaintegerrequired

Código de la marca de vehículo

Example: cdMarca=40
cdModelointegerrequired

Código del modelo de vehículo

Example: cdModelo=1
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/vehiculos/versiones?cdPlan=1&cdMarca=40&cdModelo=1' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY_HERE' \
  -H 'x-codigo-mediador: YOUR_API_KEY_HERE' \
  -H 'x-user-key: YOUR_API_KEY_HERE'

Responses

Consulta exitosa

Bodyapplication/json
payloadArray of objects(Version)
Response
application/json
{
  "payload": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}