Fluyio Developers

Fluyio utiliza versiones de API identificadas por fecha. Los cambios incompatibles se publicarán bajo una versión fechada distinta.

Nombre de la versión

El formato es YYYY-MM-DD. Actualmente hay una versión publicada:

2026-05-15

La URL base sigue siendo https://fluyio.com/api/v1; la cabecera indica el contrato solicitado.

Fijar la versión

Incluye esta cabecera en cada petición:

Fluyio-Version: 2026-05-15

Si la omites se usa 2026-05-15, que es el valor predeterminado actual. Fijarla explícitamente facilita el mantenimiento de tu integración.

Actualmente no hay un ajuste de versión predeterminada por cuenta o clave en el panel. La selección se realiza mediante la cabecera de la petición.

Versión de la respuesta

La respuesta incluye Fluyio-Version cuando ha sido procesada por la capa de versionado. Consérvala en tus registros de diagnóstico.

HTTP/1.1 200 OK
Fluyio-Version: 2026-05-15
Fluyio-Request-Id: req_3f9a1c7e5b2d8f4a6c0e9b1d3f

Errores de validación

HTTP	Código	Motivo
400	`invalid_version_header`	La cabecera no tiene formato de fecha `YYYY-MM-DD`.
400	`unknown_version`	La fecha no corresponde a una versión disponible.

El cuerpo incluye supported_versions:

{
  "error": {
    "type": "invalid_request_error",
    "code": "unknown_version",
    "message": "Unknown API version \"2025-01-01\". See \"supported_versions\" for the list of accepted values.",
    "request_id": "req_3f9a1c7e5b2d8f4a6c0e9b1d3f",
    "supported_versions": ["2026-05-15"]
  }
}

Cambios compatibles e incompatibles

Requieren una nueva versión los cambios de nombre o eliminación de campos, rutas o parámetros, los cambios de tipo o significado y los nuevos parámetros obligatorios. También una validación más estricta puede alterar peticiones antes aceptadas.

Se pueden añadir parámetros opcionales con valores predeterminados compatibles, campos de respuesta, recursos y nuevos códigos de error dentro de tipos existentes. Ignora campos de respuesta desconocidos para permitir esas ampliaciones.

Retirada de versiones

Al publicar una nueva versión, Fluyio prevé mantener la anterior al menos 12 meses y anunciar la retirada en el historial de cambios y por email a las cuentas que sigan utilizándola. Las correcciones de seguridad son la excepción prevista y se comunican individualmente.

Versiones publicadas

Versión	Estado	Contenido
`2026-05-15`	Actual	Primera beta pública: suscriptores, claves API, paginación por cursor, idempotencia y formato de errores.

Consulta errores y el historial para seguir los cambios.

Versionado