GoFastTickets · Développeurs

Public API v1

Pilotez un compte revendeur : événements, annonces, publication, opérations en lot, liens de paiement, billets, ventes et statistiques.

Schéma OpenAPI JSON État de l'API

Authentification

Chaque requête privée utilise une clé liée à un seul compte. Ne transmettez aucun e-mail dans les requêtes.

Authorization: Bearer gft_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl https://www.gofasttickets.com/api/v1/me \
  -H "Authorization: Bearer $GFT_API_KEY"

La clé doit rester sur un serveur ou dans un gestionnaire de secrets. Ne l'intégrez jamais dans du JavaScript public.

Routes

GET/me

GET/events

GET/events/{event_uuid}

GET/listings

POST/listings

GET/listings/{listing_uuid}

PATCH/listings/{listing_uuid}

DELETE/listings/{listing_uuid}

POST/listings/{listing_uuid}/publish

POST/listings/{listing_uuid}/unpublish

POST/listings/{listing_uuid}/duplicate

POST/listings/bulk

GET/listings/{listing_uuid}/payment-link

POST/listings/{listing_uuid}/tickets/{slot_index}

GET/sales

GET/stats

Créer une annonce

curl -X POST https://www.gofasttickets.com/api/v1/listings \
  -H "Authorization: Bearer $GFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_uuid": "00000000-0000-0000-0000-000000000000",
    "quantity": 2,
    "location": {
      "category": "Catégorie 1",
      "block": "B101",
      "row": "8",
      "seat": "21-22"
    },
    "pricing": {"cost_price": "150.00", "sale_price": "190.00"},
    "side_by_side": true,
    "status": "draft"
  }'

Le statut published déclenche les contrôles de paiement et le dépôt de garantie du vendeur. Créez d'abord un brouillon si vous souhaitez valider les données avant publication.

Pagination et erreurs

Les collections acceptent page et per_page (maximum 100). Les erreurs contiennent toujours un code, un message, un resolution_hint et un request_id.

{
  "error": {
    "code": "validation_error",
    "message": "Annonce incomplète pour publication.",
    "resolution_hint": "Corrigez les champs décrits, puis renvoyez la requête.",
    "request_id": "7f7f9169-0da2-4ed7-bda2-c72e8cbecdb7"
  }
}

Permissions

account:read — compte et compteurs
events:read — catalogue d'événements
listings:read — annonces et liens de paiement
listings:write — gestion complète des annonces et billets
sales:read — ventes et statistiques

Limitation de débit

Limite par défaut : 300 requêtes par minute et par clé. Toutes les réponses fournissent RateLimit, RateLimit-Policy ainsi que les champs de compatibilité RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset. Une réponse 429 fournit également Retry-After : attendez au moins ce nombre de secondes avant de reprendre. Conservez aussi X-Request-Id pour le support.