API publique (lecture seule)

Public read-only API for AI agents and integrations

Permet de récupérer les informations des pages d'établissement 予約Lite (menus, tarifs, créneaux disponibles). Aucune authentification n'est requise. La confirmation des réservations ne peut pas être effectuée via l'API. Veuillez diriger vos clients vers la page de réservation de l'établissement https://yoyakulite.com/book/{slug} へ案内してください。

OpenAPI 3.1 : https://yoyakulite.com/openapi.json
API catalog (RFC 9727) : https://yoyakulite.com/.well-known/api-catalog
Toutes les heures sont au format ISO 8601 (UTC). Le fuseau horaire de l'établissement (ex. : Asia/Tokyo) est également renvoyé. Les tarifs s'entendent TTC (en yens).

`GET /api/stores/{slug}`

Renvoie le nom de l'établissement, l'état d'ouverture des réservations, la date limite d'annulation, ainsi que les menus réservables (durée, tarif TTC, options).slug correspond à la fin de l'URL de la page de réservation.

curl https://yoyakulite.com/api/stores/demo-salon

`GET /api/availability/month?slug=&serviceId=&month=YYYY-MM`

Renvoie le nombre de créneaux disponibles par jour pour le menu indiqué. Pour ajouter des options, utilisez options=id1,id2(la durée étant allongée, les disponibilités changent).

curl "https://yoyakulite.com/api/availability/month?slug=demo-salon&serviceId=<services[].id>&month=2026-10"

`GET /api/availability?slug=&serviceId=&date=YYYY-MM-DD`

Renvoie les heures de début réservables pour la date indiquée (slots).Lorsque les réservations sont suspendues, error: "paused" est ajouté.

curl "https://yoyakulite.com/api/availability?slug=demo-salon&serviceId=<services[].id>&date=2026-10-01"

`GET /api/version`

Version en service (contrôle de santé).

curl https://yoyakulite.com/api/version

Erreurs

400 bad_request(paramètre manquant ou format incorrect),400 unknown_option、404 not_found(établissement introuvable),404 service_not_found。Le texte est {"error": "..."} est.

À propos de l'utilisation

Veuillez éviter les accès massifs susceptibles de perturber l'activité des établissements. La réservation par procuration et la confirmation automatique ne sont pas prises en charge. Pour toute question, utilisez les coordonnées indiquées dans les Mentions légales (loi sur les transactions commerciales spécifiées).