L’API de gestion (JSON)

Pour les logiciels qui parlent JSON, à la manière d’Airbnb : annonces, calendrier jour par jour et réservations.

Vous éditez un PMS, un channel manager ou l’outil d’une conciergerie, et vos clients veulent être réservables en direct sur Reloge.com, sans commission. Reloge.com parle le langage que vos connecteurs connaissent déjà : en JSON, à la manière d’Airbnb (annonces, calendrier jour par jour, réservations), sur cette page ; en XML OpenTravel, à la manière de Booking.com (stock, prix, restrictions, réservations), sur la page Connecter votre logiciel. Les deux portes partagent les mêmes accès.

Le modèle : hébergement, établissement, exemplaires

Sur Reloge.com, ce qui se réserve est un hébergement (type: unit). Des hébergements peuvent être réunis dans un établissement (type: establishment), qui porte la présentation commune ; le calendrier, les prix et les réservations se tiennent toujours par hébergement. Un hébergement peut compter plusieurs exemplaires identiques (units) : Reloge.com vend alors un stock.

  • Location meublée indépendante (appartement, maison, gîte) : un hébergement seul, un exemplaire.
  • Chambres d’hôtes : un établissement « chambres d’hôtes », un hébergement par chambre, ou par type de chambre avec ses exemplaires.
  • Hôtel, résidence de tourisme, village de vacances : un établissement, un hébergement par type de chambre ou d’appartement, avec le nombre de chambres identiques en exemplaires.
  • Camping : un établissement « camping », un hébergement par type (emplacement, mobil-home, chalet, tente aménagée), avec ses exemplaires.
  • Groupes : un locataire réserve plusieurs hébergements d’un même établissement en une fois ; chaque hébergement reçoit sa réservation, et toutes portent le même group_id.
  • Capacités ajoutées : un établissement porte autant d’hébergements que nécessaire, chacun avec sa capacité, ses prix et son calendrier.

L’établissement et ses hébergements se créent aujourd’hui depuis l’espace du propriétaire (ou par Reloge.com pour un parc, sur demande) ; leur identifiant (heb_…, eta_…) est celui que l’API lit et écrit.

Adresse et authentification

Adresse de base : https://reloge.com/wp-json/reloge-api/v1/. Réponses en JSON, dates au format AAAA-MM-JJ, montants en euros, toutes taxes comprises.

Le propriétaire crée un accès pour votre logiciel dans son espace : page Accès logiciels, sous « Mon compte », qui donne aussi les identifiants de tous ses logements (le même bloc figure dans l’onglet Calendrier de chaque logement). C’est lui qui le fait, même s’il a confié ses logements à une conciergerie : un accès est une clé de son compte, qui vaut pour tous ses logements. Il vous transmet un identifiant et un jeton, que vous envoyez à chaque appel :

Authorization: Bearer rlo_0123456789ab:VOTRE_JETON

HTTP Basic (identifiant, jeton) est aussi accepté. Un accès ne voit que les logements de son propriétaire. Au plus 120 requêtes par minute et par accès (au-delà, 429 et Retry-After).

Logements

GET https://reloge.com/wp-json/reloge-api/v1/listings
GET https://reloge.com/wp-json/reloge-api/v1/listings?type=unit
GET https://reloge.com/wp-json/reloge-api/v1/listings/heb_0123456789abcdef01234567

Chaque logement : id, type (unit ou establishment), parent_id, name, property_type, registration_number, classification (3_stars, unclassified…), person_capacity, bedrooms, units, address, status (listed ou unlisted), url, min_nights_default, check_in_time, check_out_time ; un établissement liste ses hébergements dans children. GET /me vérifie un accès.

Annonces : créer et mettre à jour

Votre logiciel dépose l’annonce lui-même, sans que le propriétaire la ressaisisse : texte, adresse, capacité, équipements, horaires, frais et photos. Elle naît en brouillon dans le compte de l’accès ; sa mise en ligne attend, comme toute annonce, la validation du propriétaire (numéro d’enregistrement, déclaration sur l’honneur, vérification de son identité), puis la relecture de Reloge.com.

POST https://reloge.com/wp-json/reloge-api/v1/listings
Authorization: Bearer rlo_0123456789ab:VOTRE_JETON
Content-Type: application/json

{"name": "Villa des Pins", "description": "Grande maison au calme, à 5 minutes de la plage...", "property_type": "villa",
 "address": {"street": "12 chemin des Pins", "city": "Lacanau", "postal_code": "33680", "lat": 45.0012, "lng": -1.1951},
 "person_capacity": 8, "bedrooms": 4, "bathrooms": 2, "surface_m2": 140, "check_in_time": "16:00", "check_out_time": "10:00",
 "daily_price": 180, "cleaning_fee": 120, "cleaning_fee_mandatory": true, "linen_fee": 15, "tourist_tax_by_commune": true,
 "house_rules": "Non fumeur. Pas de fête.", "amenities": ["wifi", "piscine_privee", "Lave-vaisselle"],
 "photos": [{"url": "https://votre-logiciel.example/p/1.jpg", "caption": "Façade", "is_main": true}]}

La réponse (201) donne l’annonce, son identifiant (heb_…) et to_complete, ce qui reste à faire avant la mise en ligne. parent_id (eta_…) range l’hébergement dans un établissement du compte. amenities accepte les identifiants de GET https://reloge.com/wp-json/reloge-api/v1/amenities (qui donne aussi les property_types et, pour chaque équipement, ses codes OpenTravel), les codes OpenTravel eux-mêmes ("HAC:54", "RMA:2", correspondance entière) ou vos propres libellés, rapprochés des nôtres. Montants en euros. Au-delà des logements compris dans l’offre du compte : 409 (limit_reached).

PATCH https://reloge.com/wp-json/reloge-api/v1/listings/heb_0123456789abcdef01234567
{"description": "...", "amenities": ["wifi", "climatisation"]}

Seuls les champs envoyés changent. Une annonce déjà en ligne repasse en relecture pour son nom et son texte. Les horaires, frais, règlement et annulation sont repris à la création ; ensuite, ce sont les conditions du propriétaire qui font foi. Une valeur saisie par le propriétaire n’est jamais écrasée.

POST https://reloge.com/wp-json/reloge-api/v1/listings/heb_0123456789abcdef01234567/photos
{"photos": [{"url": "https://votre-logiciel.example/p/2.jpg", "caption": "Salon"}]}
GET https://reloge.com/wp-json/reloge-api/v1/listings/heb_0123456789abcdef01234567/photos

Les photos (adresses HTTPS, JPEG, PNG ou WebP) sont téléchargées par Reloge.com, quelques-unes par minute, converties et rangées dans l’ordre envoyé, la principale en tête (202, photos_queued). Au-delà du nombre de photos permis pour le logement, elles sont refusées (photos_refused).

Calendrier, jour par jour

GET https://reloge.com/wp-json/reloge-api/v1/listings/heb_0123456789abcdef01234567/calendar?start_date=2026-12-13&end_date=2026-12-16
{"listing_id": "heb_0123456789abcdef01234567", "currency": "EUR", "days": [
  {"date": "2026-12-13", "available": true, "status": "available", "units_available": 1, "daily_price": 95, "min_nights": 2, "check_in_allowed": true}
]}

status : available, booked (réservé sur Reloge.com), blocked (pris ailleurs : calendrier iCal ou logiciel), closed (fermé par le propriétaire ou par votre logiciel), pending (paiement en cours). 366 jours au plus par lecture.

Pour écrire, envoyez des opérations par plages de dates, comme au calendrier d’Airbnb. Chaque champ est facultatif :

PUT https://reloge.com/wp-json/reloge-api/v1/listings/heb_0123456789abcdef01234567/calendar
Authorization: Bearer rlo_0123456789ab:VOTRE_JETON
Content-Type: application/json

{"operations": [
  {"dates": ["2026-12-13:2026-12-16"], "daily_price": 120, "min_nights": 3},
  {"dates": ["2026-12-16"], "available": false},
  {"dates": ["2026-12-13"], "units": 4}
]}

daily_price : le prix de la nuit, qui prime sur les prix saisis à la main ; min_nights : le séjour minimum pour une arrivée ce jour-là (avec le prix en place si vous n’en envoyez pas) ; available: false ferme la nuit, available: true retire une fermeture posée par un logiciel ; units plafonne le stock vendable. Dates d’hier à 730 jours. La réponse donne nights_updated et, par opération refusée, une erreur.

Réservations

GET https://reloge.com/wp-json/reloge-api/v1/reservations?updated_since=2026-11-13
GET https://reloge.com/wp-json/reloge-api/v1/reservations?listing_id=eta_…&start_date=2026-12-13
GET https://reloge.com/wp-json/reloge-api/v1/reservations/req_…

Les réservations faites sur Reloge.com et les séjours réservés ailleurs que le propriétaire suit sur Reloge.com : confirmation_code, listing_id, parent_listing_id, group_id, channel, status (accepted ou cancelled), start_date, end_date (départ), nights, guests, guest (first_name, last_name, email, phone, locale), total_price, paid_amount, balance_due.

guest.email est une adresse propre au séjour : écrivez-y, messages automatiques compris, depuis l’adresse d’expédition de votre choix. Le message parvient au locataire par la messagerie de Reloge.com, qui en garde la trace dans le dossier du séjour, et ses réponses arrivent dans la messagerie du propriétaire. locale est sa langue (code ISO 639-1). Sans locataire enregistré (séjour réservé ailleurs, sans fiche), email et phone valent null.

Ne redemandez jamais ce qui est réglé. Le locataire paie sur le compte de paiement du propriétaire, jamais chez Reloge.com : paid_amount est déjà sur ce compte, seul balance_due reste dû.

Une réservation prise ailleurs (Airbnb, Booking.com…), que votre logiciel connaît avant le calendrier iCal, se dépose pour fermer ses nuits sur Reloge.com :

POST https://reloge.com/wp-json/reloge-api/v1/reservations
Authorization: Bearer rlo_0123456789ab:VOTRE_JETON
Content-Type: application/json

{"listing_id": "heb_0123456789abcdef01234567", "channel": "airbnb", "external_code": "HMABC123", "start_date": "2026-12-13", "end_date": "2026-12-16",
 "units": 1, "adults": 2, "children": 0, "guest": {"first_name": "Jean", "last_name": "Dupont"}}

Canaux : airbnb (Airbnb), booking (Booking.com), abritel (Abritel), gites (Gîtes de France), autre (Une autre plateforme). La réponse (201) donne son code, ext-airbnb-HMABC123 ; la même réservation renvoyée ne ferme rien de plus, et des dates changées déplacent la fermeture. Des nuits déjà réservées sur Reloge.com rendent 409 avec ces nuits : rien n’est fermé, le propriétaire tranche. DELETE https://reloge.com/wp-json/reloge-api/v1/reservations/ext-airbnb-HMABC123 l’annule et rouvre ses nuits ; une réservation faite sur Reloge.com s’annule depuis l’espace du propriétaire, selon ses conditions (403).

D’Airbnb et de Booking.com à Reloge.com

  • Une annonce Airbnb, un room type Booking.com : un hébergement (heb_…, l’InvTypeCode en OpenTravel) ; un hotel Booking.com : un établissement (eta_…, le HotelCode).
  • Les jours du calendrier Airbnb (available, daily_price, min_nights) : les mêmes noms ici ; les opérations par plages de dates aussi.
  • Le stock et les restrictions Booking.com : BookingLimit, RestrictionStatus Close, LengthsOfStay SetMinLOS, en OpenTravel ; le prix par nombre de personnes (BaseByGuestAmt) y est lu pour le plus grand nombre.
  • Le contenu d’une annonce : POST /listings ici, OTA_HotelDescriptiveContentNotifRQ en OpenTravel, comme pour Booking.com.
  • Une réservation : confirmation_code ici, HotelReservationID en OpenTravel, avec le montant déjà réglé (DepositPayments).

Erreurs

Toujours la même forme : {"error": {"code": "…", "message": "…"}}. 400 requête illisible, 401 accès refusé, 403 geste interdit, 404 logement ou réservation inconnus, 409 conflit de dates, 422 geste impossible (un établissement n’a pas de calendrier propre), 429 quota, 503 API fermée.

Ce qui arrive

Les prochaines étapes, dans cet ordre : les messages, des notifications JSON à chaque réservation (aujourd’hui, Reloge.com envoie déjà chaque réservation en OpenTravel à l’adresse de votre logiciel), l’arrivée ou le départ fermés et le séjour maximum, et un accès unique pour une conciergerie qui gère pour plusieurs propriétaires.

Pour un accès d’essai ou une question : contactez-nous, nous testons la compatibilité avec vous et affinons si besoin.