{"openapi":"3.1.0","info":{"title":"API publique Walliko","version":"1.0.0","description":"Crée des cartes et ajoute des visites depuis ta caisse ou ton logiciel de réservation."},"servers":[{"url":"https://api.walliko.fr/public/v1"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Clé API Walliko (psk_live_…), à créer dans Paramètres > API."}},"schemas":{"Card":{"type":"object","properties":{"serial":{"type":"string"},"shortCode":{"type":"string","example":"WLK-20481-YB"},"stamps":{"type":"number"},"points":{"type":"number"},"lifetimeVisits":{"type":"number"},"progress":{"type":"object","properties":{"value":{"type":"number"},"target":{"type":"number"},"ratio":{"type":"number"}},"required":["value","target","ratio"]},"availableRewards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"threshold":{"type":"number"}},"required":["id","title","threshold"]}},"links":{"type":"object","properties":{"card":{"type":"string","format":"uri"},"appleWallet":{"type":"string","format":"uri"},"googleWallet":{"type":"string","format":"uri"}},"required":["card","appleWallet","googleWallet"]}},"required":["serial","shortCode","stamps","points","lifetimeVisits","progress","availableRewards","links"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}},"parameters":{}},"paths":{"/cards":{"post":{"summary":"Créer (ou retrouver) la carte d’un client","security":[{"apiKey":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"programId":{"type":"string","format":"uuid"},"firstName":{"type":"string","minLength":1,"maxLength":40},"phone":{"type":"string","example":"+33612345678"},"email":{"type":"string","format":"email"}},"required":["programId","firstName"]}}}},"responses":{"200":{"description":"Carte","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"description":"Erreur","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/visits":{"post":{"summary":"Ajouter une visite (passage en caisse, rendez-vous honoré…)","security":[{"apiKey":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"programId":{"type":"string","format":"uuid"},"serial":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string","format":"email"},"establishmentId":{"type":"string","format":"uuid"},"amountCents":{"type":"integer","minimum":0},"idempotencyKey":{"type":"string","maxLength":64}}}}}},"responses":{"200":{"description":"Carte mise à jour","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Card"},{"type":"object","properties":{"unlocked":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"threshold":{"type":"number"}},"required":["id","title","threshold"]}}},"required":["unlocked"]}]}}}},"429":{"description":"Anti-fraude","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/cards/{serial}":{"get":{"summary":"Lire une carte","security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"serial","in":"path"}],"responses":{"200":{"description":"Carte","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"404":{"description":"Introuvable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"webhooks":{}}