Versiones
Elige la versión de la API de tu integración; Billete nunca la cambia por debajo.
Cada petición dice con qué versión de la API está escrita, en la cabecera Billete-Version. Una versión publicada no cambia nunca: lo incompatible sale como una versión nueva, y tu integración sigue funcionando igual hasta que decides actualizarla.
curl https://api.billete.run/v1/customers \
-H "Authorization: Bearer $BILLETE_API_KEY" \
-H "Billete-Version: 2026-10-24"La cabecera es obligatoria. Sin ella la API responde 400 api_version_missing; con una versión que no existe, api_version_invalid; con una retirada, api_version_retired. Con el SDK no la escribes a mano: la opción apiVersion de createBillete y createClient es obligatoria y la envía en cada petición.
Estables y betas
| Versión | Ejemplo | Qué es |
|---|---|---|
| Estable | 2026-11-01 | La recomendada para integrar. |
| Beta | 2026-11-01.beta | Trae cambios antes que la próxima estable. También sirve en producción y tampoco cambia una vez publicada, pero dura menos. |
Elige la versión que lees en el selector de la barra lateral; el historial de versiones dice qué cambió en cada una. El nombre es el día en que se publicó. Lo que solo agrega (endpoints nuevos, campos opcionales, filtros) llega a todas las versiones vigentes sin cambiar ninguna: tu código debe ignorar los campos que no conoce.
Retiro
- Una versión estable funciona hasta 6 meses después de que se publique la siguiente estable. Te avisamos 90 días antes de retirarla, y siempre se retiran primero las más viejas.
- Una beta funciona hasta 14 días después de que se publique la estable que la sigue.
Te avisamos por correo y en el dashboard solo si tu negocio usa esa versión. Para saberlo, Billete registra qué versión y qué SDK usa cada negocio en sus peticiones; no registra datos de tus clientes. En Desarrolladores → Versiones de la API ves las versiones vigentes, cuáles usa tu negocio y cuándo se retira cada una.
Webhooks
Cada webhook tiene su propia versión: los eventos le llegan con la forma de esa versión. Por defecto es la de la petición que lo crea; envía apiVersion al crearlo o actualizarlo para elegir otra vigente. Si su versión se retira, el webhook pasa a la versión vigente más antigua y te avisamos.