Firme Broker de Seguros

API para desarrolladores

API REST pública de solo lectura con la identidad verificable, las coberturas y las compañías de Firme. Pensada para que agentes de IA y desarrolladores consulten datos y deriven usuarios a WhatsApp.

Sin API keys, sin sandbox — a propósito

No hay autenticación ni registro: todos los endpoints son públicos y de solo lectura, sobre datos que ya están publicados en este sitio. Tampoco hay sandbox, porque no hace falta: nada muta, así que producción es el entorno seguro de prueba. La API no cotiza precios, no emite pólizas y no expone datos de clientes.

Quickstart

curl https://firmeseguros.com/api/v1/info
curl https://firmeseguros.com/api/v1/coberturas
curl "https://firmeseguros.com/api/v1/coberturas?especialidad=true"
curl "https://firmeseguros.com/api/v1/companias?q=federacion"

La especificación completa, con schemas tipados y operationIds, está en /openapi.json (OpenAPI 3.1).

Endpoints

  • GET /api/v1/info — identidad del broker: matrícula SSN verificable en el registro público, CUIT, contacto, horarios y zonas de reuniones presenciales.
  • GET /api/v1/coberturas — los 7 ramos, cada uno con su link de WhatsApp pre-escrito para derivar al usuario. Parámetro opcional especialidad (boolean).
  • GET /api/v1/companias — las 16 compañías. Parámetro opcional q (búsqueda por nombre, sin distinguir tildes).

GET /api devuelve este mismo índice en JSON, para descubrimiento programático.

Errores: siempre JSON

Ningún error de la API devuelve HTML. El formato es estable:

{
  "error": {
    "code": "not_found",
    "message": "Qué pasó, en una frase.",
    "hint": "Cómo resolverlo o dónde seguir.",
    "docs": "https://firmeseguros.com/openapi.json"
  }
}

Códigos en uso: not_found, invalid_parameter (400), method_not_allowed (405) y rate_limited (429).

Rate limits

60 pedidos por minuto por IP. Toda respuesta de la API incluye los headers RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y RateLimit-Policy; si te pasás, recibís un 429 con Retry-After en segundos. El límite se aplica best-effort en el origen: las respuestas se cachean 1 hora en el CDN, así que para uso normal nunca lo vas a tocar — y los contadores de una respuesta cacheada pueden venir de otro pedido.

Versionado y deprecación (deprecation policy)

La versión va en la URL: /api/v1. Las reglas:

  • Agregar campos nuevos a una respuesta no es un cambio incompatible: tu cliente tiene que tolerar campos que no conoce.
  • Un cambio incompatible crea /api/v2. La versión anterior sigue funcionando al menos 6 meses más.
  • Una versión en retirada lo anuncia con los headers Deprecation y Sunset en sus respuestas, y en esta página. Hoy ninguna versión está deprecada, por eso esos headers no aparecen: cuando aparezcan, significan retiro programado.

In English: breaking changes ship as a new version under /api/v2; the previous version keeps working for at least 6 months and signals retirement with the Deprecation and Sunset response headers. This section is the canonical deprecation policy page, also referenced as x-deprecation-policy in the OpenAPI spec.

Markdown para agentes

Todas las páginas HTML del sitio sirven una versión markdown por negociación de contenido: mandá el header Accept: text/markdown y recibís Content-Type: text/markdown con Vary: Accept. La guía del sitio para LLMs está en /llms.txt.

curl -H "Accept: text/markdown" https://firmeseguros.com/

¿Y un CLI o SDK?

No publicamos uno: con 3 endpoints GET sin autenticación, curl o cualquier cliente HTTP alcanzan y sobran. Si tu caso de uso necesita más superficie, escribinos a atencion@firmeseguros.com y contanos qué estás construyendo.