Documentation API Google Reserve

Version: 1.0 • Généré pour l’API Symfony Digiresa

Sommaire

• Introduction
• Authentification
• Codes d’erreur
• Feeds
• Availability Lookup
• Réservations (Create / Update / Cancel)
• Lecture (Status / Details)
• En-têtes utiles
• Variables d’environnement
• Base de données & Migration
• Opérations & Observabilité
• Page de test

Introduction

Cette API expose les endpoints nécessaires à une intégration Google Reserve: feeds (merchant/services/availability), recherche de disponibilités, création/modification/annulation de réservations et lecture de statut/détails.

Authentification

• Sandbox / Prod Authorization: Basic <base64(user:pass)> — identifiants issus de GOOGLE_BASIC_USER / GOOGLE_BASIC_PASS (rotation semestrielle recommandée).
• Toutes les routes /v3/** et /google/** (sauf /google/health) sont protégées.

Codes d’erreur

Feeds

Merchant

GET /google/feed/merchant/{guid}

Champs: id, name, phone (E.164), email, website_url, address, currency, timezone, open_hours[], location, place_id.

Services

GET /google/feed/services/{guid}

Retourne une liste de services actifs (mono-service respecté si configuré).

Availability

GET /google/feed/availability/{guid}?start=YYYY-MM-DD&end=YYYY-MM-DD

• spots_total: capacité brute par slot.
• spots_open: capacité restante (brute − occupation). Les slots 0 ne sont pas publiés.
• Cutoff jour J: today_booking_*_max_hour, fallback form_closed_* (HH:mm ou fermeture).

Availability Lookup

POST /v3/BatchAvailabilityLookup
Authorization: Basic <base64>
Content-Type: application/json
{
  "merchant_id": "1234",
  "slot_time": [
    {
      "service_id": "5678",
      "start_sec": "1606467600",
      "duration_sec": "1800",
      "resource_ids": { "party_size": 2 }
    },
    ...
  ]
}

Réponse: { "slot_time_availability": [ { slot_time, available }, ... ] }

Réservations

Create

POST /v3/CreateBooking
Authorization: Basic <base64>
Content-Type: application/json
{
  "idempotency_token": "rng-1234",
  "slot": {
    "merchant_id": "1234",
    "service_id": "5678",
    "start_sec": "1606467600",
    "duration_sec": "1800",
    "resources": { "party_size": 2 },
    "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
  },
  "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" },
  "user_information": {
    "given_name": "John",
    "family_name": "Smith",
    "email": "[email protected]",
    "telephone": "+12091111111",
    "user_id": "1111111111111111111"
  }
}

Update (MODIFY / CANCEL)

POST /v3/UpdateBooking
Authorization: Basic <base64>
Content-Type: application/json
{
  "idempotency_token": "rng-5678",
  "booking": {
    "booking_id": "890",
    "slot": {
      "start_sec": "1606473000",
      "duration_sec": "1800"
    }
  }
}

Pour une annulation, la spec Google passe également par /v3/UpdateBooking avec l’action adéquate dans le payload.

Lecture

GET /google/get-booking-status?merchant_id=...&booking_id=...

GET /google/get-booking-details?merchant_id=...&booking_id=...

En-têtes utiles

• Authorization: Basic obligatoire.
• X-Idempotency-Key (create/update/cancel).
• X-Request-Id (corrélation).

Variables d’environnement

Base de données & Migration

Script SQL: sql/migration_001_google_reserve.sql

• Table idempotency_keys pour idempotence persistée (+ purge TTL à prévoir)
• Colonnes booking.service_id, status, cancellation_reason et index utiles
• Optionnel: booking_events (audit)

Opérations & Observabilité

• Logs structurés, p95 latence, 4xx/5xx, alerting
• Rate limiting (Redis)
• Backups DB, rollbacks, healthcheck
• Notifications temps réel (BookingNotification) via GOOGLE_RTU_*

Page de test

Ouvrir / pour tester feeds et réservations. Renseigner vos identifiants Basic avant de lancer les appels.