Uso desde agentes de IA
Esta documentación está escrita para que la lean personas y máquinas. Todo lo que necesita un agente está disponible como texto plano.
Documentación legible por máquinas
| Recurso | URL | Para qué sirve |
|---|---|---|
llms.txt |
/es/llms.txt |
Un índice de la documentación con una línea por página |
llms-full.txt |
/es/llms-full.txt |
Todas las guías y la referencia de la API en un solo fichero |
| Páginas en Markdown | Añade .md a la URL de cualquier página, por ejemplo /es/inicio-rapido.md |
Leer una página sin HTML |
| Referencia de la API en Markdown | /reference.md (en inglés) |
Todas las operaciones, esquemas y ejemplos |
| OpenAPI 3.1 | /openapi.json · /openapi.yaml |
Generar clientes y definiciones de herramientas |
Todos se sirven con Access-Control-Allow-Origin: *.
Servidor MCP
Próximamente. Un servidor MCP remoto en mcp.salchimail.com permitirá a un agente verificar direcciones, lanzar lotes y consultar el uso con tu clave de API. Esta página lo enlazará cuando esté disponible.
Skill para agentes
Próximamente. Una skill que enseña a un asistente de programación a integrar SalchiMail. Esta página la enlazará cuando esté disponible.
Hasta que existan, apunta tu agente a /es/llms.txt o al contrato OpenAPI: basta para llamar a la API correctamente.
Reglas para tu agente
Si escribes tú las instrucciones, incluye estas:
- La clave de API es un secreto. Léela de una variable de entorno, envíala solo a
https://api.salchimail.comy no la imprimas nunca. - Construye y prueba con una clave
sk_test_: los resultados son simulados y no se consumen créditos (Entorno de pruebas). - Nunca trates
unknowncomoinvalid(Veredictos y reason codes). - Para más de unas pocas direcciones, crea un lote en lugar de repetir
POST /verify(Limpieza de listas por lotes). - Envía una
Idempotency-Keyen cadaPOSTy reutilízala en los reintentos (Idempotencia). - Decide según
verdict,reason_codey elcodedel error. Nunca analicesreasonnimessage. - Una verificación nunca envía un email. No digas a los usuarios que se ha enviado un mensaje a la dirección.