# Desarrolladores y agentes — Surify

> Surify no tiene una API pública del CRM. Lo que sí es público, sin cuenta ni llave, es el contenido de surify.mx en Markdown, el índice llms.txt, el sitemap y una especificación OpenAPI que describe exactamente eso.

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](https://surify.mx/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](https://surify.mx/llms.txt), el texto completo [llms-full.txt](https://surify.mx/llms-full.txt) (documentación, glosario, aseguradoras y demos en un solo archivo), el [sitemap](https://surify.mx/sitemap.xml) y la especificación [openapi.json](https://surify.mx/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](https://surify.mx/) y las [preguntas frecuentes](https://surify.mx/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](https://surify.mx/docs), 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](https://surify.mx/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](https://surify.mx/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](https://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`:

```bash
curl -sS -H 'Accept: text/markdown' https://surify.mx/
```

Un artículo de la documentación por sufijo, sin cabeceras:

```bash
curl -sS https://surify.mx/docs/whatsapp-y-email/vincular-whatsapp.md
```

Índice y especificación:

```bash
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 [hola@surify.mx](mailto:hola@surify.mx) 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.

---

Página: https://surify.mx/desarrolladores