Versiones y retirada de la API de SingleFax
Los agentes y los servidores pueden basarse en esta política. La API REST actual es /api/v1. No hay una fecha prevista para retirarla.
Versionado
La versión de la API REST pública figura en la ruta URL: https://singlefax.com/api/v1/…, con las mismas rutas en api.singlefax.com. El documento OpenAPI está en /openapi.json, y info.version coincide con la versión principal de la ruta, actualmente 1.0.0.
Los cambios compatibles con versiones anteriores —campos opcionales, endpoints y valores de error data.code nuevos— siguen en v1 sin necesidad de un encabezado. Los cambios incompatibles, como eliminar campos, cambiar tipos o exigir nueva autenticación, se publican como /api/v2. No modificamos sin aviso la estructura de las solicitudes ni de las respuestas de v1.
Retirada y fin de soporte
Cuando se vaya a retirar una operación o un campo de v1, sus respuestas incluirán RFC 8594 Deprecation, con la fecha del aviso, y RFC 8594 Sunset, con la fecha en que dejará de funcionar. Sunset será al menos 90 días después de Deprecation. OpenAPI marca esas mismas operaciones con deprecated: true.
Actualmente, ninguna operación de v1 incluye los encabezados Deprecation o Sunset. MCP Streamable HTTP en /mcp aplica el mismo plazo de aviso si se retira una herramienta.
Dónde consultar esta información mediante código
- Esta página: /versioning
- Markdown: /versioning.md
- OpenAPI: /openapi.json
- Índice de agente: /llms.txt
- Portal del desarrollador: /developers