Guías

Versionado

Cómo está versionada la API de Inspow.

La API de Inspow usa versionado por URL (URI versioning). La versión va incluida en la ruta de cada petición, lo que te permite migrar a tu propio ritmo cuando se publiquen cambios incompatibles.

Esquema de versión

Todas las rutas comparten el prefijo api y, a continuación, la versión:

https://api.inspow.tech/api/v1/<recurso>

La versión por defecto es la 1. Si omites la versión en una petición, se resuelve la versión por defecto, pero recomendamos indicarla siempre de forma explícita para evitar sorpresas en el futuro.

Versión	Ruta base	Estado
v1	`/api/v1`	Estable

Endpoints sin versión

Algunos endpoints son version-neutral: no llevan número de versión en la ruta, porque los llaman sistemas externos con una URL configurada de antemano y deben mantenerse estables aunque cambie la versión de la API:

Endpoint	Ruta	Uso
Salud	`/api/health` (y `/api/health/ready`, `/api/health/live`)	Comprobación del estado del servicio.
Webhooks de pagos	`/api/payments/<pasarela>/webhook`	Eventos de la pasarela de pagos (ver Webhooks).
Webhook de WhatsApp	`/api/wa/webhook`	Eventos de Meta para el agente de WhatsApp.
Webhooks de integraciones	`/api/integrations/webhooks/...`	Eventos de sistemas contables conectados.