Descargas
El contrato completo de la API en OpenAPI 3.1: importalo en tus herramientas o generá un cliente con tipos.
El documento OpenAPI
Está siempre al día en https://kicket.club/api/v1/openapi.json. Es público (no pide token) y trae todas las rutas, los parámetros, los objetos, los errores, los permisos y ejemplos de cada respuesta.
curl -s https://kicket.club/api/v1/openapi.json -o kicket-api-v1.openapi.jsonPostman
- Tocá Import, pegá la URL del documento y elegí importarlo como colección.
- En la colección, pestaña Authorization: tipo OAuth 2.0, Grant type Client Credentials, Access Token URL
https://kicket.club/api/v1/oauth/token, tu Client ID y tu Client Secret, Client Authentication Send as Basic Auth header. - Tocá Get New Access Token y después Use Token. Todas las rutas de la colección lo heredan.
Insomnia
- Import › From URL y pegá la URL del documento.
- En la colección, Auth › OAuth 2.0, Grant Type Client Credentials, con la Access Token URL de arriba y tu credencial.
Generar un cliente
TypeScript: los tipos con openapi-typescript
Genera los tipos de cada objeto y cada ruta. Lo usás con tu propio fetch, o con openapi-fetch.
npx openapi-typescript https://kicket.club/api/v1/openapi.json -o kicket-api.d.tsimport type { components } from './kicket-api'
type Venta = components['schemas']['Sale']
type Pago = components['schemas']['Payment']Otros lenguajes: openapi-generator
Genera un cliente completo en Python, Java, C#, Go, PHP y muchos más. Necesita Java instalado (o usá su imagen de Docker).
npx @openapitools/openapi-generator-cli generate \
-i https://kicket.club/api/v1/openapi.json \
-g python \
-o kicket-api-pythonEl archivo de la credencial
Al crear o rotar una credencial, el panel te ofrece bajar kicket-api.env con KICKET_API_URL, KICKET_CLIENT_ID y KICKET_CLIENT_SECRET: son las variables que usan todos los ejemplos de esta guía. Guardalo fuera de cualquier repositorio.