API REST — Réservations en Ligne

Le site web du GOLDEN-K RESORT (golden-k.cm) dispose d’un système de réservation en ligne intégré permettant aux clients de réserver des chambres directement depuis le site.

Une API REST a été activée afin de permettre au logiciel de gestion hôtelière MATRIIX HOTEL de récupérer automatiquement ces réservations en temps réel.

L’API est protégée et nécessite une authentification pour chaque requête. Toute tentative d’accès sans authentification retourne une erreur 401 Unauthorized.

Crédentiels d’accès

Construction du header Authorization

L’authentification se fait en encodant username:password en Base64 et en l’ajoutant dans le header HTTP :

Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Exemple avec curl :

curl -u "username:password" \
  "https://golden-k.cm/en/wp-json/wp/v2/bookings?per_page=10"

Exemple en PHP :

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://golden-k.cm/en/wp-json/wp/v2/bookings");
curl_setopt($ch, CURLOPT_USERPWD, "username:password");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$bookings = json_decode($response, true);

Exemple en JavaScript / Node.js :

const response = await fetch(
  "https://golden-k.cm/en/wp-json/wp/v2/bookings",
  {
    headers: {
      "Authorization": "Basic " + btoa("username:password")
    }
  }
);
const bookings = await response.json();

URL de base de l’API :

Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Paramètres de pagination

Paramètres de tri

Paramètres de filtrage par date

En-têtes de réponse pour la pagination

Chaque réponse liste inclut des en-têtes HTTP donnant les informations de pagination :

💡 Exemples de requêtes combinées

# Toutes les réservations, 50 par page, du plus récent au plus ancien
GET /wp/v2/bookings?per_page=50&orderby=date&order=desc

# Nouvelles réservations depuis le 1er mai 2026
GET /wp/v2/bookings?after=2026-05-01T00:00:00&orderby=date&order=asc

# Page 2 avec 20 résultats par page
GET /wp/v2/bookings?per_page=20&page=2&orderby=date&order=desc

Requête : Récupérer une réservation par ID

Réponse (200 OK) :

{
  "id": 1381,
  "date": "2026-05-04T15:44:25",
  "modified": "2026-05-04T15:44:25",
  "slug": "booking-hilary-danielle",
  "status": "publish",
  "title": { "rendered": "Booking: hilary danielle" },
  "created_at": "2026-05-04 15:44:25",
    // ─── Informations client ───────────────────────────────
  "client_name": "hilary danielle",
  "client_email": "hilarydanielle90@gmail.com",
  "client_phone": "699150867",
    // ─── Dates du séjour ────────────────────────────────
  "check_in": "2026-11-13",
  "check_out": "2026-11-15",
  "guests": "1",
  "nights": "2",
    // ─── Chambre & tarif ────────────────────────────────
  "room_id": "181",
  "room_name": "Standard Room",
  "total_price": "100000",
  "currency": "XAF",
    // ─── Statut ───────────────────────────────────────────
  "booking_status": "new",
  "is_new": "1",
  "confirm_call": "0",
  "confirm_email": "0"
}

Requête : Liste des réservations (réponse réduite)

Headers de réponse :

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
X-WP-Total: 18
X-WP-TotalPages: 9

Body (tableau JSON) :

[
  { "id": 1381, "client_name": "hilary danielle", "check_in": "2026-11-13", "booking_status": "new", ... },
  { "id": 1380, "client_name": "Jordan Yantchoukam", "check_in": "2026-05-12", "booking_status": "new", ... }
]

Réponse sans authentification (401) :

{
  "code": "rest_not_logged_in",
  "message": "Authentification requise pour acceder aux reservations. Utilisez un Application Password.",
  "data": { "status": 401 }
}