Développeurs

Connectez Teranga à vos systèmes

Authentification par clé API, endpoints REST, webhooks sortants. Un SDK officiel n'est pas encore disponible — l'API REST directe fonctionne dès aujourd'hui.

Démarrage rapide Référence complète des endpoints
Démarrage rapide

Votre premier appel authentifié

1. Créez une clé API

Connectez-vous en tant qu'Owner ou DAF, puis allez dans Clés API dans la barre latérale. La clé n'est affichée en clair qu'une seule fois, à la création — copiez-la immédiatement.

Guide complet : gérer les clés API →

2. Authentifiez vos requêtes

Chaque appel à l'API doit inclure votre clé dans l'en-tête X-Api-Key.

curl https://api.votre-etablissement.teranga.app/api/availability.json \
  -H "X-Api-Key: votre_cle_api"

3. Créez une réservation externe (exemple Channel Manager)

curl -X POST https://api.votre-etablissement.teranga.app/api/external-bookings \
  -H "X-Api-Key: votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "roomId": "...",
    "checkIn": "2026-09-01",
    "checkOut": "2026-09-03",
    "guestEmail": "client@example.com"
  }'

Une facture et un paiement sont générés automatiquement à la création de la réservation.

Webhooks sortants

Teranga prévient vos systèmes

Configurez un webhook pour être notifié quand un événement se produit dans votre établissement — nouvelle réservation, paiement confirmé, stock bas — sans avoir à interroger l'API en boucle.

Ressources

Pour aller plus loin

Référence API

Panorama complet des endpoints, organisés par domaine fonctionnel.

Consulter →

Architecture technique

Stack, structure du projet, principes de sécurité.

Consulter →

RBAC : rôles et permissions

Ce que chaque rôle peut faire, et les workflows automatiques associés.

Consulter →

Plugin WordPress

Intégrer un formulaire de réservation avec paiement FedaPay sur un site externe.

Consulter →