Kunden abrufen
GET /v1/clients/:id liefert einen Kunden und den Stand seiner Stempelkarte, Stempel, Punkte und einzulösende Prämien.
/v1/clients/:idLiefert 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 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:
{
"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
}
}| Feld | Bedeutung |
|---|---|
carte | Der Code der Karte, der in ihrem QR-Code steckt |
lien_carte | Die Seite der Karte, die das Hinzufügen zu Apple Wallet oder Google Wallet anbietet |
etat.tampons, etat.points | tampons in den Modi Stempel und Stufen, points im Punktemodus; der andere Wert ist null |
etat.restants | Was bis zur nächsten Prämie noch fehlt |
etat.recompenses_disponibles | Die 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.