Enregistrer et consulter des critères de recherche pour un client

  • Customers
  • Réservation
  • 2 routes
Comment enregistrer puis retrouver des critères de recherche dans le compte d'un client ?

Ce scénario explique comment enregistrer un ensemble de critères de recherche dans le compte d'un client puis le relire plus tard pour relancer une recherche à partir de préférences mémorisées.

Vue d'ensemble

Utilisez POST/v0/customers/{customer_id}/bookmarks pour persister des recherches sauvegardées puis GET/v0/customers/{customer_id}/bookmarks pour les relire depuis l'espace client.

Prérequis

  • Le customer_id doit correspondre à un compte client existant.
  • Les routes de bookmarks supposent de disposer du scope client attendu.
  • accept-language et x-api-key sont requis sur les appels documentés.

Process workflow

Legend:
Obligatoire
Optionnel
1

Enregistrer des critères de recherche

Obligatoire

Utilisez POST/v0/customers/{customer_id}/bookmarks pour persister une recherche sauvegardée dans le compte client afin de pouvoir réutiliser les critères de séjour plus tard.

Prérequis

  • Header accept-language
  • Header authorization
  • Header x-api-key
  • Path customer_id
  • La route attend un body, mais son schéma détaillé n’est pas visible dans l’extrait de contrat disponible. Le payload doit porter les critères à sauvegarder, par exemple le produit ciblé et le contexte de séjour.

Calling CURL

curl -X POST "https://api.clubmed.com/v0/customers/123456789/bookmarks" \
  -H "accept-language: fr-FR" \
  -H "authorization: Bearer <token>" \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json"

Example answer

HTTP/1.1 201 Created

info: Le body de réponse détaillé n’est pas exposé dans l’extrait de contrat disponible. Utilisez cette étape quand vous avez besoin d’un favori persistant au niveau du compte client et non d’un simple état front temporaire.

Codes de réponse

  • 201 : critères enregistrés avec succès.
  • 400 : requête invalide, erreur de validation ou JSON invalide.
  • 401 : authentification invalide ou absente.
  • 403 : mismatch client ou issuer mismatch.
POST/v0/customers/{customer_id}/bookmarks
Voir plus
2

Consulter les critères enregistrés

Obligatoire

Utilisez GET/v0/customers/{customer_id}/bookmarks pour récupérer les recherches précédemment sauvegardées dans le compte client et les afficher dans un parcours de reprise.

Prérequis

  • Header accept-language
  • Header authorization
  • Header x-api-key
  • Path customer_id

Calling CURL

curl --get "https://api.clubmed.com/v0/customers/123456789/bookmarks" \
  -H "accept-language: fr-FR" \
  -H "authorization: Bearer <token>" \
  -H "x-api-key: <your-api-key>"

Example answer

[
  {
    "id": "1",
    "product_id": "MPAC",
    "resort_arrival_date": "20260117",
    "resort_departure_date": "20260117",
    "number_attendees": 2,
    "departure_option_id": "PAR",
    "price": {
      "amount": 80,
      "currency": "EUR"
    }
  }
]

info: Réutilisez l’id du bookmark et les critères de séjour retournés pour reconstruire une carte de recherche sauvegardée ou rouvrir la sélection produit dans le même contexte.

Codes de réponse

  • 200 : recherches sauvegardées retournées avec succès.
  • 400 : requête invalide ou erreur de validation.
  • 401 : authentification invalide ou absente.
  • 403 : mismatch client ou issuer mismatch.
GET/v0/customers/{customer_id}/bookmarks
Voir plus