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.com y 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 unknown como invalid (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-Key en cada POST y reutilízala en los reintentos (Idempotencia).
  • Decide según verdict, reason_code y el code del error. Nunca analices reason ni message.
  • Una verificación nunca envía un email. No digas a los usuarios que se ha enviado un mensaje a la dirección.

Ver esta página en Markdown