Zum Inhalt springen

Für KI-Agenten: Das Verzeichnis der Dokumentation steht unter https://stampywallet.com/de/docs/llms.txt, die gesamte Dokumentation in einer Datei unter https://stampywallet.com/de/docs/llms-full.txt, und diese Seite gibt es als Markdown: https://stampywallet.com/de/docs/api/kunden-abrufen.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
API und Webhooks / Referenz / Kunden abrufenAls Markdown ansehen

Kunden abrufen

GET /v1/clients/:id liefert einen Kunden und den Stand seiner Stempelkarte, Stempel, Punkte und einzulösende Prämien.

GET /v1/clients/:id

Liefert einen Kunden und den Stand seiner Karte. :id ist die UUID, die POST /v1/clients oder GET /v1/clients zurückgibt. Eine unbekannte ID antwortet mit 404 client_introuvable.

curl
curl https://app.stampywallet.com/v1/clients/c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7 \
  -H "Authorization: Bearer sw_live_votre_cle"

Das Kundenobjekt

Dasselbe Objekt kommt in allen Kundenrouten zurück und im Feld client der anderen Antworten:

200 OK
{
  "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
  "prenom": "Léa",
  "nom": "Martin",
  "telephone": "0612345678",
  "email": "lea@exemple.fr",
  "carte": "X7k2pQ9mLw",
  "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw",
  "cree_le": "2026-10-22T09:14:03.120Z",
  "etat": {
    "mode": "tampons",
    "tampons": 3,
    "points": null,
    "objectif": 10,
    "restants": 7,
    "prochaine_recompense": { "seuil": 10, "libelle": "Ein Kaffee gratis" },
    "recompenses_disponibles": [
      { "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab", "libelle": "Ein Kaffee gratis", "seuil": 10,
        "piste": "normal", "obtenue_le": "2026-10-20T16:03:44.000Z", "expire_le": null }
    ],
    "recompenses_obtenues": 1,
    "dernier_passage": "2026-10-22T09:20:00.000Z",
    "premium": null
  }
}
FeldBedeutung
carteDer Code der Karte, der in ihrem QR-Code steckt
lien_carteDie Seite der Karte, die das Hinzufügen zu Apple Wallet oder Google Wallet anbietet
etat.tampons, etat.pointstampons in den Modi Stempel und Stufen, points im Punktemodus; der andere Wert ist null
etat.restantsWas bis zur nächsten Prämie noch fehlt
etat.recompenses_disponiblesDie verdienten, noch nicht eingelösten Prämien: Mit ihrer id können Sie sie einlösen
etat.premium{ nom, tampons, objectif, restants }, wenn das Geschäft den zweiten Zähler aktiviert hat, sonst null

Hinweis : IDs sind UUIDs. Die Präfixe cli_, pas_ oder rec_ vor einer UUID werden bei der Eingabe akzeptiert und ignoriert.

War diese Seite hilfreich?