Entwicklerintegration
Mit dem 7stamp Integration API kann ein CRM, eine E-Commerce-Plattform, ein POS, ein benutzerdefiniertes Backend oder ein Automatisierungstool Wallet-Treuekarten mit dem Kontakt verwalten Kennung, die Ihr eigenes System bereits verwendet. Dies ist die universelle Option, wenn keine spezielle Integration vorhanden ist.
Die API-Basis URL ist https://api.7loc.com/cards-api. Authentifizieren Sie jede Anfrage mit einem API-Schlüssel als Bearer-Token. Verwenden Sie die verlinkte OpenAPI-Referenz für die Live-Anfrage- und -Antwortschemata, bevor Sie die Produktionslogik erstellen.
machen können Das API ist die Schreibseite des Integrationsstapels. Verwenden Sie es immer dann, wenn Ihre eigene Software die operative Quelle der Wahrheit bleiben soll, während 7stamp die Wallet-Treueschicht verwaltet.
Generieren Sie einen persönlichen Wallet-Kartenlink für jeden Kunden in Ihrem System. Versenden Sie es über Ihre eigene E-Mail, SMS, Push oder In-App-Flow. Der Kunde öffnet den Link und speichert die Karte unter Apple Wallet oder Google Wallet.
Wenn ein Kauf in Ihrem benutzerdefinierten POS abgeschlossen wird, wenn eine Online-Bestellung auf Ihrer Website bezahlt wird oder wenn eine Dienstleistung in Ihrem Buchungssystem abgeschlossen wird, rufen Sie API auf, um Stempel gutzuschreiben. Die Karte wird innerhalb von Sekunden aktualisiert.
Stellen Sie einem bestimmten Kunden einen einmaligen Gutschein aus, erstellen Sie kampagnenbereite Prämienflüsse und übertragen Sie den Gutscheinstatus zurück in die Systeme, die Finanzen und Servicequalität verwalten.
Dies sind die öffentlichen API Routen hinter dem Make und Zapier Aktionen. Lesen Sie das genaue Schema in der Referenz API; Feldnamen nicht von einem anderen Endpunkt ableiten.
POST /cards/invite Erstellt eine neue persönliche Installation URL für einen externen Kontakt.
POST /cards/invite/bulk Erstellt bis zu 100 Einladungslinks in einem kontrollierten Stapel.
GET /cards Sucht Kartendatensätze anhand der externen Kontaktkennung.
GET /cards/{user_card_id} Gibt den vollständigen Status einer Karte anhand ihrer internen 7stamp ID zurück.
POST /cards/scan Fügt Stempel nach Karte ID oder External ID hinzu und zeichnet die Quellreihenfolge bei Lieferung auf.
GET /templates Listet die für den Arbeitsplatz des Schlüssels verfügbaren Kartenvorlagen auf/profile.
GET /templates/{template_id}/design Liest visuelle Einstellungen für einen bekannten Kartenvorlage.
POST /vouchers/issue Stellt einem Karteninhaber einen Gutschein aus.
POST /messages/send Sendet Wallet-Card-Push- und /or E-Mail-Inhalte an einen Karteninhaber.
Dies sind echte 7stamp Admin-Bildschirme. Öffnen Sie API & Integrations, fügen Sie einen Schlüssel hinzu und kopieren Sie ihn dann in ein sicheres serverseitiges Geheimnis oder eine Automatisierungsverbindung.
Erstellen Sie den Schlüssel in 7stamp Admin unter API Integrations → API Keys → Add API Key. Ein Schlüssel gehört zu einem Arbeitsplatz/profile. Erstellen Sie daher separate Schlüssel für Entwicklung und Produktion, wenn Ihre Kontoeinrichtung dies zulässt. Rotieren oder entziehen Sie den Zugriff über das Dashboard, wenn ein Geheimnis preisgegeben wird.
External ID ist die stabile Kontaktkennung aus Ihrem System: eine CRM ID, ein Kunde UUID, eine Telefonnummer oder eine E-Mail. Bevorzugen Sie ein unveränderliches System ID. Fügen Sie optional External Source hinzu, um systemübergreifende Kollisionen zu vermeiden und die Webhook-Korrelation explizit zu machen.
Wenn das Profil eine aktive Vorlage hat, kann template_id weggelassen werden und 7stamp wählt sie automatisch aus. Wenn mehrere aktive Vorlagen vorhanden sind, übergeben Sie den vorgesehenen template_id. Lesen Sie zuerst GET /templates, anstatt ein vermutetes ID fest zu codieren.
bash curl -X POST "https://api.7loc.com/cards-api/cards/invite" \
-H "Authorization: Bearer YOUR_7STAMP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}'Melden Sie sich bei 7stamp Admin an und erstellen Sie einen Schlüssel: API Integrations → API Keys → Add API Key. Speichern Sie es in Ihrem Secret Manager, nicht im Quellcode oder in einer clientseitigen Anwendung.
Setzen Sie die Basis URL auf https://api.7loc.com/cards-api und fügen Sie Authorization hinzu: Bearer gefolgt vom Schlüssel zu jeder serverseitigen Anfrage.
Rufen Sie zuerst GET /templates an. Eine erfolgreiche Antwort bestätigt das Token und zeigt die für diesen Arbeitsplatz verfügbaren Vorlagen an. /profile.
Wählen Sie das stabile External ID und das optionale External Source aus Ihrem eigenen System. Verwenden Sie in der Erstellungs-, Scan-, Such- und Webhook-Logik genau dasselbe Identitätspaar.
Rufen Sie POST /cards/invite mit einem Einweg-Testkontakt an. Überprüfen Sie die zurückgegebene Installation URL, bevor Sie die Lieferung an echte Kunden automatisieren.
Fügen Sie POST /cards/scan, Gutschein- oder Nachrichtenaktionen erst hinzu, nachdem Sie Protokollierung, Fehlerbehandlung und eine sichere Wiederholungsstrategie/idempotency in Ihrem eigenen Backend haben.
Die öffentliche Swagger/OpenAPI-Referenz enthält die aktuellen Endpunkt-, Parameter-, Anforderungstext-, Antwort- und Webhook-Schemata. Der interaktive URL ist https://api.7loc.com/cards-api/docs und der maschinenlesbare Vertrag ist https://api.7loc.com/cards-api/openapi.json. Lesen Sie ihn, bevor Sie die Fehlerbehandlung implementieren oder optionale Felder hinzufügen.
Der Schlüssel ist ein serverseitiges Geheimnis. Stellen Sie es nicht in Browser-JavaScript, einem mobilen App-Bundle, einem öffentlichen Formular, Screenshots, Make/Zapier-Textfeldern oder Support-Tickets bereit. Verwenden Sie einen Server, eine sichere Automatisierungsverbindung oder einen Secret Manager. Sollte der Schlüssel jemals versehentlich weitergegeben werden, widerrufen oder rotieren Sie ihn in 7stamp Admin und aktualisieren Sie die betroffene Verbindung.
Gehen Sie in 7stamp Admin zu API Integrations → API Keys → Add API Key. Das Token wird dann im Header Authorization als Bearer gefolgt vom Schlüssel gesendet.
Verwenden Sie https://api.7loc.com/cards-api und senden Sie Authorization: Bearer YOUR_7STAMP_API_KEY bei jeder autorisierten Anfrage.
Nur wenn das verbundene Profil genau eine aktive Kartenvorlage hat. Wenn mehrere Vorlagen aktiv sind, wählen Sie die richtige template_id aus GET /templates.
Verwenden Sie API für ein benutzerdefiniertes POS, Backend, Site oder Vollzugriff. Verwenden Sie Make für visuelle Verzweigungsszenarien. Verwenden Sie Zapier für einen überwiegend linearen Trigger-Aktions-Workflow. Alle drei basieren auf demselben API-Schlüssel und API-Vertrag.
Verwandte Seiten
Nächster Schritt
Erstellen Sie den Schlüssel, rufen Sie GET /templates an, erstellen Sie eine Einladung für einen verfügbaren Kontakt und fügen Sie dann Produktionsgeheimnisse, Protokollierung, Wiederholungsversuche und Webhook-Verarbeitung rund um die bewährte Anfrage hinzu.