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

Catálogo de Provincias

Request

Consulta el catálogo completo de provincias de República Dominicana para servicios que requieren especificar direcciones físicas del cliente.

Este endpoint retorna las 32 provincias sin requerir parámetros.

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
curl -i -X GET \
  https://intermediarios-api.humano.com.do/_mock/apis/catalogos/catalogo/provincias \
  -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(Provincia)
Response
application/json
{
  "payload": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}

Catálogo de Municipios

Request

Consulta el catálogo de municipios para servicios que requieren especificar direcciones físicas del cliente.

Los municipios están organizados jerárquicamente por provincia.

Parámetro obligatorio: cdProvincia es requerido.

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

Código de la provincia

Example: cdProvincia=32
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/catalogos/catalogo/municipios?cdProvincia=32' \
  -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(Municipio)
Response
application/json
{
  "payload": [
    { … },
    { … },
    { … }
  ]
}

Catálogo de Sectores

Request

Consulta el catálogo de sectores para servicios que requieren especificar direcciones físicas del cliente.

Los sectores están organizados jerárquicamente por provincia y municipio.

Parámetros obligatorios: todos los parámetros son requeridos.

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

Código de la provincia

Example: cdProvincia=1
cdMunicipiointegerrequired

Código del municipio

Example: cdMunicipio=1
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/catalogos/catalogos/sectores?cdProvincia=1&cdMunicipio=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(Sector)
Response
application/json
{
  "payload": [
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}

Servicio de Cotizaciones

Endpoints para gestionar cotizaciones

Operations

Servicio de Vehículos

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

Operations