API hôtelière B2B pour les professionnels du voyage

Ce que couvre l’API

Le parcours hôtelier suit l’ordre d’une vraie réservation : recherche d’une destination, demande de disponibilité en direct pour un hôtel, checkout de l’option choisie (le prix est revalidé auprès du fournisseur à ce stade), paiement, confirmation, puis liste, consultation ou annulation des réservations. Les prix renvoyés incluent déjà le markup configuré pour votre agence.

La même clé d’API fonctionne aussi pour les transferts privés, y compris le service de chauffeur à l’heure, et pour la location de voitures. Vous intégrez un schéma d’authentification, un format d’erreur et un journal d’utilisation pour les trois produits.

BASE="https://api.trekko.co/core"
AUTH="Authorization: ApiKey trk_test_xxxxxxxx:your_secret_here"

# 1) Search for the city
curl -sS "${BASE}/accommodation/search?query=Barcelona" -H "${AUTH}"

# 2) Live availability (prices already include your markup)
curl -sS -X POST "${BASE}/accommodations/get_accommodation_availability" \
  -H "${AUTH}" -H "Content-Type: application/json" \
  -d '{
        "accommodation_id": 1376114,
        "start_date": "2027-04-12",
        "end_date": "2027-04-15",
        "guests": [ { "id": 1, "age": 34 }, { "id": 2, "age": 30 } ],
        "guests_room_distribution": [ { "guest_ids": [1, 2] } ],
        "nationality": "ES",
        "currency_code": "EUR"
      }'

Conçue pour le trafic de production

Les API de réservation échouent de façon coûteuse : un délai d’attente pendant la confirmation peut créer une réservation en double. L’appel de confirmation accepte un en-tête Idempotency-Key : une nouvelle tentative avec la même clé renvoie la réponse d’origine au lieu de réserver deux fois.

Les limites de requêtes s’appliquent par clé d’API et non par adresse IP, et celles de chaque agence sont indépendantes : le trafic d’un autre partenaire ne ralentit jamais le vôtre. Les erreurs partagent une même enveloppe, et les erreurs d’authentification distinguent comme d’usage identifiants inconnus et identifiants valides sans autorisation.

Webhooks et rebooking automatique

Les réservations passées par l’API sont éligibles au rebooking automatique de Trekko : tant que l’annulation gratuite est ouverte, la réservation est contrôlée chaque jour pour détecter un tarif plus bas sur le même séjour. Quand un rebooking a lieu, votre réservation conserve le même identifiant stable, et votre système reçoit un webhook booking.rebooked signé, avec l’ancien et le nouveau prix ainsi que l’économie réalisée.

Les webhooks sont signés en HMAC pour que vous puissiez vérifier qu’ils viennent de Trekko ; la livraison est au moins une fois, avec des nouvelles tentatives automatiques, et chaque événement porte un identifiant sur lequel dédoublonner. Vous pouvez aussi exclure du rebooking une réservation donnée par l’API.

D’abord le sandbox, la production quand le compte est approvisionné

Inscrivez-vous au sandbox avec votre e-mail, saisissez le code que nous envoyons, et vous recevez aussitôt des identifiants de test. Le sandbox exécute toute la boucle de réservation sur un catalogue de test fixe, n’appelle jamais un vrai fournisseur, ne déplace jamais d’argent, et comprend un simulateur de rebooking pour tester le flux de webhooks à la demande.

L’approvisionnement du compte ne demande aucune intégration de paiement distincte. Vous approvisionnez votre compte Trekko jusqu’au dépôt minimum, par recharge de carte, virement ou ligne de crédit convenue, demandez l’accès à la production et, une fois la demande approuvée par l’équipe Trekko, vous l’activez pour recevoir votre clé live. Pour passer du sandbox à la production, vous changez la clé et l’URL de base, ajoutez l’étape de paiement, envoyez la confirmation complète et gérez les erreurs que le sandbox ne produit pas.

Une check-list d’intégration

Conservez l’identifiant de réservation stable renvoyé à la confirmation, et non le numéro de confirmation du fournisseur, qui peut changer après un rebooking. Envoyez un Idempotency-Key à chaque confirmation. Vérifiez la signature de chaque webhook avant d’agir, et dédoublonnez sur l’identifiant d’événement. Montrez à vos utilisateurs l’échéance d’annulation renvoyée avec chaque offre.

Qui intègre l’API Trekko

Des agences de voyages en ligne qui ajoutent l’hôtellerie à leurs sites, des voyagistes qui alimentent un moteur de packaging dynamique, des outils de réservation d’entreprise qui ont besoin de séjours et de transport terrestre, et des start-up du voyage qui veulent de l’inventaire sans négocier des contrats fournisseur un à un.

Questions fréquentes