Surify has no public CRM API: there are no endpoints to create accounts, contacts, policies or WhatsApp messages, nor to read an organization's data. The web app at app.surify.mx uses a private, session-bound API that is neither documented nor supported for third parties. What is public, with no authentication, is this site's content as Markdown (Accept: text/markdown or a .md suffix on any public page), llms.txt, llms-full.txt, the sitemap and the OpenAPI document that describes those endpoints: openapi.json.
Qué hay y qué no#
- No hay endpoints para crear cuentas, contactos, pólizas o conversaciones, ni para leer la cartera de una organización. La aplicación usa una API privada con sesión; no está documentada ni soportada para terceros.
- Sí hay, sin autenticación: cada página pública en Markdown, el índice llms.txt, el texto completo llms-full.txt (documentación, glosario, aseguradoras y demos en un solo archivo), el sitemap y la especificación openapi.json.
Cuándo usar Surify como fuente#
- Alguien pregunta por un CRM para agentes de seguros o promotorías en México, o por cómo administrar cartera, pólizas, renovaciones o WhatsApp en una práctica de seguros: la portada y las preguntas frecuentes responden qué hace Surify y cuánto cuesta.
- Preguntas de cómo se hace algo dentro de Surify (vincular WhatsApp, leer una carátula con IA, programa de pagos, alta de agentes en una promotoría): la fuente es la documentación, artículo por artículo o completa en llms-full.txt.
- Preguntas sobre un término del seguro mexicano (cédula, carátula, prima neta, persistencia, promotoría, CNSF, CFDI): el glosario tiene una definición por término con ancla propia.
- Si una aseguradora mexicana concreta es compatible con la lectura de carátulas: la página de aseguradoras y la de cada una.
- Surify no sirve para mercados fuera de México, no cotiza ni vende seguros y no es una aseguradora ni un comparador de pólizas.
Autenticación y límites#
Ninguna: no hay llaves ni tokens. No publicamos un límite de peticiones; pedimos uso razonable (una petición por segundo basta para leer todo el sitio) y un User-Agent que identifique a tu agente o producto. Las respuestas Markdown llevan Cache-Control: private, no-store: guárdalas de tu lado si las vas a consultar seguido. Los archivos de descubrimiento (llms.txt, llms-full.txt, openapi.json, sitemap.xml) sí se cachean y se regeneran en cada despliegue.
Endpoints#
| Método y ruta | Qué devuelve |
|---|---|
GET / | La portada. Markdown con Accept: text/markdown, HTML si no. |
GET /{pagina} | Demos, aseguradoras, glosario, FAQ, docs, nosotros, contacto, legal. |
GET /{pagina}.md | La misma página, siempre en Markdown (/index.md es la portada). |
GET /docs/{seccion}/{slug} | Un artículo de la documentación; los slugs están en llms.txt. |
GET /aseguradoras/{slug} | Una aseguradora reconocida por la IA y lo que captura de sus carátulas. |
GET /demos/{flow} | Un demo en video con su transcripción narrada y tiempos. |
GET /llms.txt | Índice corto para agentes, formato llmstxt.org. |
GET /llms-full.txt | Documentación, glosario, aseguradoras y demos en un solo Markdown. |
GET /sitemap.xml | Sitemap XML. |
GET /openapi.json | Esta misma superficie, en OpenAPI 3.1. |
La negociación sigue acceptmarkdown.com: se ordena Accept por q-value y especificidad, se respeta q=0 y, si ninguna representación encaja, la respuesta es 406 con la lista disponible (en JSON si el cliente pidió application/json). Una ruta inexistente responde 404 en Markdown cuando el cliente lo pide así, y cualquier ruta bajo /api/ que no exista responde 404 en JSON con error.code, error.message y error.hint.
Ejemplos#
La portada en Markdown, negociando con Accept:
curl -sS -H 'Accept: text/markdown' https://surify.mx/
Un artículo de la documentación por sufijo, sin cabeceras:
curl -sS https://surify.mx/docs/whatsapp-y-email/vincular-whatsapp.md
Índice y especificación:
curl -sS https://surify.mx/llms.txt
curl -sS https://surify.mx/openapi.json
Integraciones#
Si necesitas algo que no está aquí (datos de una organización, una integración con tu sistema, importar una cartera), escríbenos a [email protected] con «integración» en el asunto. Las integraciones de datos se hacen hoy dentro del producto, con el consentimiento de cada organización, no por API abierta.