Accès & clés API

Avant votre premier appel, votre contact Brave Booking vous fournit un jeu d'identifiants partenaire. Cette page décrit ce que vous recevez et comment l'utiliser.

Environnements

Chaque partenaire dispose de deux environnements indépendants :

Environnement	Base URL	Clés	Usage
Test	`https://partners.bravebooking.net`	préfixe `test_`	Intégration, recette, jeux de données de démonstration
Production	`https://partners.bravebooking.net`	préfixe `live_`	Trafic réel

Les deux environnements partagent la même URL de base : c'est la clé envoyée (test ou prod) qui détermine l'environnement. Les réservations créées avec une clé de test sont des réservations de test.

Ce que vous recevez

X-Api-Key — votre clé publique (ex. VOTRE_CLE_API), présente dans chaque requête de la porte Brave.
Le secret — montré une seule fois à la création. Il ne sert qu'à calculer la signature ; il n'est jamais transmis dans les requêtes. Brave ne le stocke que haché.
IP autorisées — la liste des adresses IP sortantes autorisées à appeler la passerelle. Une requête depuis une autre IP est refusée (403).
Portes et formats activés — porte Brave, OS-Travel et/ou Cyberesa, en JSON et/ou XML. Seules les portes activées répondent.
Quotas — un quota d'appels par seconde et un quota par jour, propres à votre clé. Voir Quotas & limites.

Le code société

L'URL de la porte Brave contient le code société de la compagnie Brave dont vous vendez le stock :

Exemple

# code = 1000 (compagnie de démonstration)
https://partners.bravebooking.net/v1/1000/ping

Vous pouvez distribuer le stock de plusieurs sociétés Brave : changez simplement le {code} dans l'URL, avec la même clé si elle est autorisée pour ces sociétés.

Portes compatibles

Les portes OS-Travel et Cyberesa utilisent leurs propres identifiants, fournis avec votre clé Brave :

OS-Travel — Login et Password envoyés dans chaque requête (Credential). Voir OS-Travel (Octasoft).
Cyberesa — Login et Password dans le XML (<Credential>), plus votre identifiant numérique d'agence (<User>). Voir Cyberesa.

Bonnes pratiques

Stockez le secret dans un coffre de secrets, jamais dans le code ou un dépôt.
Ne partagez jamais une clé entre deux partenaires : une clé = un partenaire, traçable dans le journal d'appels.
Prévoyez la rotation : une clé peut être tournée ou révoquée à tout moment par la société Brave.

Suivant : signer vos requêtes