URL base
APP_BASE_URL seguido de /api/v1.
Haga su primera solicitud
1
Cree una clave de API
En el panel, vaya a Configuración > Claves de API y haga clic en Crear clave de API. Elija el acceso que necesita la clave. Consulte Autenticación.
2
Llame a la API
data:
Convenciones
- Las solicitudes y las respuestas usan JSON. Los nombres de los campos usan
snake_case. - Los ID son UUID y nunca cambian.
- Las marcas de tiempo usan ISO 8601 en UTC, por ejemplo
2026-09-29T13:30:00.000Z. Los cuerpos de las solicitudes también aceptan un desfase numérico como-04:00. - Las listas devuelven
data,next_cursoryhas_more. Consulte Solicitudes y errores. - Cada clave pertenece a un negocio. Nunca necesita enviar un ID de negocio.
OpenAPI
La API publica un documento OpenAPI 3.1 enGET /api/v1/openapi.json, sin necesidad de clave. LobbyStack lo genera a partir de los mismos esquemas con los que valida el servidor, así que siempre coincide con la versión en ejecución. Impórtelo en Postman, genere un cliente o consulte la sección Referencia de la API de esta documentación, que LobbyStack crea a partir del mismo archivo.
Versiones
La versión forma parte de la ruta:/api/v1. Dentro de v1, LobbyStack solo hace cambios aditivos:
- Nuevos endpoints, nuevos campos opcionales en las solicitudes y nuevos campos en las respuestas.
- Nuevos valores en listas como los tipos de eventos de webhook y los códigos de error.
/api/v2. Eliminar o cambiar el nombre de un campo, cambiar un tipo o agregar un campo obligatorio en las solicitudes se considera un cambio incompatible. Cuando sale una nueva versión, v1 sigue funcionando junto a ella. Las cargas útiles de los webhooks incluyen api_version para que sepa qué formato recibió.