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-finden.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
API und Webhooks / Referenz / Kunden findenAls Markdown ansehen

Kunden finden

GET /v1/clients findet einen Kunden über seine Telefonnummer, seine E-Mail-Adresse oder den Code seiner Karte.

GET /v1/clients

Findet einen Kunden des Geschäfts. Geben Sie nur einen der drei Abfrageparameter an (sonst 400 recherche_requise):

Abfrageparameter

telephone
string
optional
Die Nummer, in der Adresse kodiert (%2B33612345678). Sie wird im Land des Geschäfts gelesen: 0612345678 und +33612345678 werden beide gefunden.
email
string
optional
E-Mail-Adresse, ohne Beachtung der Groß- und Kleinschreibung.
carte
string
optional
Der Code der Karte, der in ihrem QR-Code steckt.

Beispiel

curl
curl "https://app.stampywallet.com/v1/clients?telephone=%2B33612345678" \
  -H "Authorization: Bearer sw_live_votre_cle"

Antwort

200 OK
{
  "clients": [
    {
      "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
      "prenom": "Léa",
      "nom": "Martin",
      "telephone": "+33612345678",
      "email": null,
      "carte": "X7k2pQ9mLw",
      "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw",
      "cree_le": "2026-10-25T10:41:52.120Z",
      "etat": { "mode": "tampons", "tampons": 7, "points": null, "objectif": 10, "restants": 3,
                "prochaine_recompense": { "seuil": 10, "libelle": "Ein Baguette gratis" },
                "recompenses_disponibles": [], "recompenses_obtenues": 1,
                "dernier_passage": "2026-10-28T08:02:11.000Z", "premium": null }
    }
  ]
}

Die Liste ist leer ("clients": []), wenn niemand passt: Das ist kein Fehler. Haben mehrere Einträge dieselbe E-Mail-Adresse oder dieselbe Nummer, wird der Kunde mit dem jüngsten Besuch zurückgegeben. Alle Felder im Detail: das Kundenobjekt.

War diese Seite hilfreich?