Développeurs

API PEAKSHI v1

Lisez les données autorisées d’un hôtel depuis votre serveur. L’API v1 est réservée aux comptes Réseau et aux partenaires approuvés.

Démarrer

Demandez un accès et décrivez votre usage.
Après validation, créez une clé depuis l’espace API du compte Réseau.
Conservez la clé uniquement côté serveur et envoyez-la dans l’en-tête Authorization.

Adresse de base

https://ahubmemuvsmzgeapwgbc.supabase.co/functions/v1/public-api

Authentification

Utilisez une clé API secrète côté serveur. Ne l’intégrez jamais dans un navigateur ou une application publique.

curl https://ahubmemuvsmzgeapwgbc.supabase.co/functions/v1/public-api/v1/hotel \
  -H "Authorization: Bearer pk_live_VOTRE_CLE"

const res = await fetch("https://ahubmemuvsmzgeapwgbc.supabase.co/functions/v1/public-api/v1/scores/history?limit=12", {
  headers: { Authorization: `Bearer ${process.env.PEAKSHI_API_KEY}` },
});
const { data } = await res.json();

Points d’accès

GET/v1/hotel

Identité de l’hôtel et dernier score mesuré.

{ "data": { "hotel_name": "Hotel Example", "city": "Lyon", "score": 62, "level": "Good", "measured_at": "2026-09-21T06:00:00Z" } }

GET/v1/scores/history

Historique des scores, du plus récent au plus ancien.

Paramètre : limit (1..200, default 52)

{ "data": [ { "score": 62, "level": "Good", "recorded_at": "2026-09-21T06:00:00Z" } ] }

GET/v1/reviews/summary

Synthèse agrégée des avis et du taux de réponse.

{ "data": { "review_count": 412, "average_rating": 4.52, "reviews_last_30_days": 18, "reply_rate": 0.87 } }

GET/v1/abell/requests

Demandes Abell, uniquement si Abell est actif sur le compte.

Paramètre : limit (1..200, default 50)

{ "data": [ { "id": "…", "guest_name": "Emma Clarke", "arrival_date": "2027-06-14", "departure_date": "2027-06-16", "guests": 2, "room_type": "Double", "status": "new", "created_at": "…" } ] }

Les exemples de réponses sont illustratifs. Les données réelles dépendent du compte autorisé.

Erreurs

Toutes les erreurs suivent ce format : { "error": { "code": "…", "message": "…" } }

HTTP	Code	Signification
401	invalid_api_key	Clé absente ou invalide
403	plan_required	Plan Réseau requis
403	abell_inactive	Abell n’est pas actif
404	not_found	Ressource introuvable
405	method_not_allowed	Méthode non autorisée
429	rate_limited	Limite de 60 requêtes par minute atteinte

Demander un accès

L’accès n’est pas automatique. Indiquez votre entreprise, votre produit et le cas d’usage prévu. Nous vérifions le périmètre avant de fournir les étapes d’accès.

POST /access-requestsapplication/json

Feuille de route

La v1 est en lecture seule. Les écritures de réservation, les webhooks et le multi-hôtels avancé sont prévus pour une version ultérieure. Présenter une intégration