Vérification de prix

Rejoue un rateKey reçu lors d'une recherche, vérifie que l'offre est toujours vendable et garantit le prix pendant 10 minutes.

POST/v1/{code}/checkrate

Requête

Corps JSON

Name
rateKey
Type
string
Description
Clé d'offre renvoyée par Disponibilités, à rejouer telle quelle.

Comportement

Réponse identique à l'offre de recherche, avec expiresAt positionné à 10 minutes.
Dans cette fenêtre, POST /bookings avec le même rateKey accepte le prix garanti.
Passé expiresAt : 422 rate_expired — relancez recherche + checkrate.

POST

/v1/1000/checkrate

curl -s -X POST "https://partners.bravebooking.net/v1/1000/checkrate" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "rateKey": "rk_x9F2kQ8example" }'

Réponse

{
  "rateKey": "rk_x9F2kQ8example",
  "hotel": { "id": 1803258, "name": "Villa Demo Stays" },
  "room": { "id": "18", "name": "Chambre Deluxe Vue Mer" },
  "boarding": { "id": 16, "name": "Petit-déjeuner" },
  "checkIn": "2027-01-15",
  "checkOut": "2027-01-20",
  "price": { "amount": 500.0, "currency": "TND", "net": true },
  "cancellation": [
    { "from": "2026-12-15", "to": "2027-01-14", "type": "PERCENT", "value": 0 },
    { "from": "2027-01-14", "type": "PERCENT", "value": 100, "nature": "NO_SHOW" }
  ],
  "confirmation": "instant",
  "expiresAt": "2026-11-13T10:25:30+01:00"
}

Erreurs

Code	Signification
`422 rate_expired`	Le `rateKey` a expiré : nouvelle recherche
`422 stop_sales`	Arrêt des ventes depuis la recherche
`422 on_request_only`	L'offre n'est plus disponible en confirmation immédiate
`404 not_found`	`rateKey` inconnu ou émis pour un autre partenaire