Integracja programistów
7stamp Integration API umożliwia CRM platformie e-commerce, POS, niestandardowemu backendowi lub narzędziu do automatyzacji zarządzanie kartami lojalnościowymi portfela za pomocą identyfikatora kontaktu Twój własny system już korzysta. Jest to opcja uniwersalna, gdy nie istnieje wyspecjalizowana integracja.
Baza API URL to https://api.7loc.com/cards-api. Każde żądanie uwierzytelniaj kluczem API jako tokenem Bearer. Użyj połączonego odniesienia OpenAPI dla aktywnych schematów żądań i odpowiedzi przed zbudowaniem logiki produkcyjnej.
API to strona zapisu stosu integracji. Używaj go, gdy Twoje własne oprogramowanie powinno pozostać operacyjnym źródłem prawdy, podczas gdy 7stamp obsługuje warstwę lojalnościową portfela.
Wygeneruj link do karty portfela osobistego dla dowolnego klienta w swoim systemie. Dostarcz go za pośrednictwem własnego e-maila, SMS, push lub w aplikacji. Klient otwiera link i zapisuje kartę pod numerem Apple Wallet lub Google Wallet.
Kiedy zakup zostanie zamknięty w Twoim niestandardowym POS, kiedy zamówienie online zostanie opłacone na Twojej stronie internetowej lub kiedy usługa zostanie zrealizowana w Twoim systemie rezerwacji, zadzwoń pod numer API, aby uzyskać znaczki kredytowe. Karta aktualizuje się w ciągu kilku sekund.
Wydaj jednorazowy kupon konkretnemu klientowi, twórz przepływy nagród gotowe do kampanii i przywracaj status kuponów do systemów zajmujących się finansami i jakością usług.
Są to publiczne API trasy za Akcje Make i Zapier. Przeczytaj dokładny schemat w odnośniku API; nie wnioskuj nazw pól z innego punktu końcowego.
POST /cards/invite Tworzy nową instalację osobistą URL dla kontaktu zewnętrznego.
POST /cards/invite/bulk Tworzy do 100 linków z zaproszeniami w kontrolowanej partii.
GET /cards Wyszukuje zapisy kart według zewnętrznego identyfikatora kontaktu.
GET /cards/{user_card_id} Zwraca pełny stan jednej karty na podstawie jej wewnętrznego 7stamp ID.
POST /cards/scan Dodaje znaczki według karty ID lub External ID i rejestruje kolejność źródłową po dostarczeniu.
GET /templates Wyświetla listę szablonów kart dostępnych w miejscu pracy klucza/profile.
GET /templates/{template_id}/design Odczytuje ustawienia wizualne dla znanego szablon karty.
POST /vouchers/issue Wydaje kupon właścicielowi karty.
POST /messages/send Wysyła push karty portfela i /or zawartość e-maila do właściciela karty.
To są prawdziwe ekrany 7stamp Admin. Otwórz API & Integracje, dodaj klucz, a następnie skopiuj go do bezpiecznego tajnego połączenia po stronie serwera lub połączenia automatycznego.
Utwórz klucz w 7stamp Admin pod API Integrations → API Keys → Add API Key. Klucz należy do jednego miejsca pracy/profile, więc utwórz osobne klucze do programowania i produkcji, jeśli pozwala na to konfiguracja konta. Obróć lub cofnij dostęp z pulpitu nawigacyjnego, jeśli ujawniony zostanie sekret.
External ID to stabilny identyfikator kontaktu z Twojego systemu: CRM ID, klient UUID, numer telefonu lub adres e-mail. Preferuj niezmienny system ID. Opcjonalnie dodaj External Source, aby uniknąć kolizji między systemami i aby korelacja elementu webhook była wyraźna.
Gdy profil ma jeden aktywny szablon, template_id można pominąć i 7stamp wybierze go automatycznie. Jeśli ma wiele aktywnych szablonów, przekaż zamierzony template_id. Najpierw przeczytaj GET /templates, zamiast wpisywać na stałe zgadnięty ID.
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
}'Zaloguj się do 7stamp Admin i utwórz klucz: API Integrations → API Keys → Add API Key. Przechowuj go w swoim tajnym menedżerze, a nie w kodzie źródłowym lub aplikacji po stronie klienta.
Ustaw bazę URL na https://api.7loc.com/cards-api i dodaj Authorization: Bearer, a następnie klucz do każdego żądania po stronie serwera.
Najpierw zadzwoń pod numer GET /templates. Pomyślna odpowiedź potwierdza token i pokazuje szablony dostępne dla tego miejsca pracy/profile.
Wybierz stabilny External ID i opcjonalny External Source z własnego systemu. Użyj dokładnie tej samej pary tożsamości w logice tworzenia, skanowania, wyszukiwania i elementu webhook.
Zadzwoń pod numer POST /cards/invite za pomocą jednorazowego kontaktu testowego. Zweryfikuj zwróconą instalację URL przed zautomatyzowaniem dostawy do prawdziwych klientów.
Dodaj POST /cards/scan, kupon lub akcje związane z wiadomościami dopiero po tym, jak masz logowanie, obsługę błędów i strategię bezpiecznego ponawiania/idempotency we własnym zapleczu.
Publiczne odwołanie Swagger/OpenAPI zawiera bieżący punkt końcowy, parametr, treść żądania, odpowiedź i schematy elementu webhook. Interaktywny URL to https://api.7loc.com/cards-api/docs, a kontrakt do odczytu maszynowego to https://api.7loc.com/cards-api/openapi.json. Przeczytaj go przed wdrożeniem obsługi błędów lub dodaniem opcjonalnych pól.
Klucz jest tajemnicą po stronie serwera. Nie ujawniaj go w JavaScript przeglądarki, pakiecie aplikacji mobilnych, formularzu publicznym, zrzutach ekranu, polach tekstowych Make/Zapier ani zgłoszeniach pomocy technicznej. Użyj serwera, bezpiecznego połączenia automatyzacji lub tajnego menedżera. Jeśli klucz zostanie kiedykolwiek przypadkowo udostępniony, unieważnij go lub obróć w 7stamp Admin i zaktualizuj odpowiednie połączenie.
W 7stamp Admin przejdź do API Integrations → API Keys → Add API Key. Token jest następnie wysyłany w nagłówku Authorization jako Bearer, po którym następuje klucz.
Użyj https://api.7loc.com/cards-api i wyślij Authorization: Bearer YOUR_7STAMP_API_KEY przy każdym autoryzowanym żądaniu.
Tylko wtedy, gdy podłączony profil ma dokładnie jeden aktywny szablon karty. Jeśli aktywnych jest wiele szablonów, wybierz właściwy template_id z GET /templates.
Użyj API, aby uzyskać niestandardowy POS, backend, witrynę lub pełną kontrolę. Użyj Make dla scenariuszy rozgałęzień wizualnych. Użyj Zapier dla przeważnie liniowego przepływu pracy wyzwalacza-akcji. Wszystkie trzy opierają się na tym samym kluczu API i umowie API.
Następny krok
Utwórz klucz, zadzwoń pod numer GET /templates, utwórz jedno zaproszenie dla jednorazowego kontaktu, a następnie dodaj sekrety produkcyjne, rejestrowanie, ponowne próby i obsługę webhooka wokół sprawdzonego żądania.