Funbooker Partner API¶
La Partner API permet aux partenaires de Funbooker d'intégrer le catalogue d'activités et de vendre des cartes cadeaux ou des bons d'activité via leur propre plateforme.
À qui s'adresse cette API ?¶
La Partner API s'adresse à deux types de partenaires :
| Type de partenaire | Usage principal | Section |
|---|---|---|
| Affilié | Afficher le catalogue Funbooker sur son site et rediriger les clients vers Funbooker pour la réservation | Guide Affiliés |
| Revendeur | Vendre des cartes cadeaux et bons d'activité directement depuis sa plateforme | Guide Revendeurs |
Obtenir un accès¶
L'accès à la Partner API se fait via une clé API (API key) fournie par l'équipe Funbooker.
Pour obtenir votre clé, contactez l'équipe partenariats Funbooker. Vous recevrez un token au format UUID (ex : 20c35ef2-d421-4da9-adc7-0e7342a7c5c0).
Authentification¶
Chaque requête doit inclure votre clé API dans le paramètre de requête apikey :
En cas de clé invalide ou absente, l'API retourne une erreur 401 Unauthorized.
URL de base¶
Référence technique¶
- Console Swagger (documentation interactive) : https://www.funbooker.com/api/partner/v1/docs#/
- Spécification OpenAPI v3 : https://www.funbooker.com/api/partner/v1/openapi.json
Endpoints disponibles¶
Catalogue (Affiliés)¶
| Méthode | Endpoint | Description |
|---|---|---|
GET |
/categories |
Liste toutes les catégories d'activités |
GET |
/categories/{id} |
Détail d'une catégorie |
GET |
/listings |
Liste paginée des activités publiées |
GET |
/listing/{slug} |
Détail d'une activité par son slug |
POST |
/search |
Recherche full-text avec filtres géographiques |
Vente (Revendeurs)¶
| Méthode | Endpoint | Description |
|---|---|---|
POST |
/giftcard/create |
Créer une carte cadeau monétaire |
DELETE |
/giftcard/{id} |
Annuler une carte cadeau |
POST |
/voucher/create |
Créer un bon cadeau pour une activité spécifique |
Format des réponses¶
Toutes les réponses sont au format JSON. Les montants monétaires sont exprimés en centimes d'euros (ex : 5000 = 50,00 EUR).
Gestion des erreurs¶
| Code HTTP | Signification |
|---|---|
200 |
Succès |
400 |
Requête invalide (paramètres manquants ou incorrects) |
401 |
Clé API invalide ou absente |
404 |
Ressource non trouvée |
500 |
Erreur interne du serveur |
Prochaines étapes¶
- Affiliés : consultez le Guide Affiliés pour apprendre à afficher le catalogue et intégrer le widget de réservation.
- Revendeurs : consultez le Guide Revendeurs pour apprendre à vendre des cartes cadeaux et bons d'activité.