Penyepaduan pembangun
7stamp Integration API membolehkan CRM, platform e-dagang, POS, hujung belakang tersuai atau alat automasi mengurus kad kesetiaan dompet dengan pengecam kenalan yang telah digunakan oleh sistem anda sendiri. Ia adalah pilihan universal apabila integrasi khusus tidak wujud.
API asas URL ialah https://api.7loc.com/cards-api. Sahkan setiap permintaan dengan kunci API sebagai token Bearer. Gunakan rujukan OpenAPI yang dipautkan untuk permintaan langsung dan skema respons sebelum membina logik pengeluaran.
API ialah bahagian tulis bagi timbunan penyepaduan. Gunakannya pada bila-bila masa perisian anda sendiri harus kekal sebagai sumber operasi kebenaran sementara 7stamp mengendalikan lapisan kesetiaan dompet.
Hasilkan pautan kad dompet peribadi untuk mana-mana pelanggan dalam sistem anda. Hantarkannya melalui e-mel anda sendiri, SMS, tolak atau aliran dalam apl. Pelanggan membuka pautan dan menyimpan kad ke Apple Wallet atau Google Wallet.
Apabila pembelian ditutup dalam adat anda POS, apabila pesanan dalam talian dibayar di tapak web anda, atau apabila perkhidmatan selesai dalam sistem tempahan anda, hubungi API untuk mendapatkan setem kredit. Kad dikemas kini dalam beberapa saat.
Keluarkan baucar sekali sahaja kepada pelanggan tertentu, buat aliran ganjaran sedia kempen dan tarik semula status baucar ke dalam sistem yang mengendalikan kewangan dan kualiti perkhidmatan.
Ini ialah laluan awam API di sebalik tindakan Make dan Zapier. Baca skema tepat dalam rujukan API; jangan membuat kesimpulan nama medan daripada titik akhir yang berbeza.
POST /cards/invite Mencipta pemasangan peribadi baharu URL untuk kenalan luaran.
POST /cards/invite/bulk Mencipta sehingga 100 pautan jemputan dalam kelompok terkawal.
GET /cards Mencari rekod kad oleh pengecam kenalan luaran.
GET /cards/{user_card_id} Mengembalikan keadaan penuh satu kad dengan 7stamp ID dalamannya.
POST /cards/scan Menambahkan setem dengan kad ID atau External ID dan merekodkan pesanan sumber apabila dibekalkan.
GET /templates Menyenaraikan templat kad yang tersedia di tempat kerja kunci/profile.
GET /templates/{template_id}/design Membaca tetapan visual untuk templat kad yang diketahui.
POST /vouchers/issue Mengeluarkan baucar kepada pemilik kad.
POST /messages/send Menghantar tolak kad dompet dan/or kandungan e-mel kepada pemilik kad.
Ini adalah skrin 7stamp Admin sebenar. Buka API & Integrasi, tambah kunci, kemudian salin ke dalam rahsia bahagian pelayan yang selamat atau sambungan automasi.
Cipta kunci dalam 7stamp Admin di bawah API Integrations → API Keys → Add API Key. Kunci kepunyaan satu tempat kerja/profile, jadi buat kunci berasingan untuk pembangunan dan pengeluaran apabila persediaan akaun anda membenarkannya. Putar atau batalkan akses daripada papan pemuka jika rahsia terdedah.
External ID ialah pengecam kenalan yang stabil daripada sistem anda: a CRM ID, pelanggan UUID, nombor telefon atau e-mel. Lebih suka sistem tidak berubah ID. Tambah External Source secara pilihan untuk mengelakkan perlanggaran merentas sistem dan untuk menjadikan korelasi webhook jelas.
Apabila profil mempunyai satu templat aktif, template_id boleh ditinggalkan dan 7stamp memilihnya secara automatik. Apabila ia mempunyai berbilang templat aktif, lulus template_id yang dimaksudkan. Baca GET /templates dahulu daripada mengekod keras ID yang diteka.
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
}'Log masuk ke 7stamp Admin dan buat kunci: API Integrations → API Keys → Add API Key. Simpannya dalam pengurus rahsia anda, bukan kod sumber atau aplikasi sebelah pelanggan.
Tetapkan asas URL kepada https://api.7loc.com/cards-api dan tambah Authorization: Bearer diikuti dengan kunci kepada setiap permintaan sebelah pelayan.
Hubungi GET /templates dahulu. Respons yang berjaya mengesahkan token dan menunjukkan templat yang tersedia untuk tempat kerja itu/profile.
Pilih stabil External ID dan External Source pilihan daripada sistem anda sendiri. Gunakan pasangan identiti yang sama dalam mencipta, mengimbas, mencari dan logik webhook.
Hubungi POST /cards/invite dengan kenalan ujian pakai buang. Sahkan pemasangan yang dikembalikan URL sebelum mengautomasikan penghantaran kepada pelanggan sebenar.
Tambah POST /cards/scan, baucar atau tindakan mesej hanya selepas anda melakukan pengelogan, pengendalian ralat dan cuba semula dengan selamat/idempotency strategi di bahagian belakang anda sendiri.
Rujukan Swagger/OpenAPI awam mengandungi titik akhir, parameter, badan permintaan, respons dan skema webhook semasa. Interaktif URL ialah https://api.7loc.com/cards-api/docs dan kontrak boleh dibaca mesin ialah https://api.7loc.com/cards-api/openapi.json. Bacanya sebelum melaksanakan pengendalian ralat atau menambah medan pilihan.
Kuncinya ialah rahsia sebelah pelayan. Jangan dedahkannya dalam JavaScript penyemak imbas, himpunan aplikasi mudah alih, borang awam, tangkapan skrin, medan teks Make/Zapier atau tiket sokongan. Gunakan pelayan, sambungan automasi selamat atau pengurus rahsia. Jika kunci pernah dikongsi secara tidak sengaja, batalkan atau putarkannya dalam 7stamp Admin dan kemas kini sambungan yang terjejas.
Dalam 7stamp Admin, pergi ke API Integrations → API Keys → Add API Key. Token kemudiannya dihantar dalam pengepala Authorization sebagai Bearer diikuti dengan kunci.
Gunakan https://api.7loc.com/cards-api dan hantar Authorization: Bearer YOUR_7STAMP_API_KEY pada setiap permintaan yang dibenarkan.
Hanya apabila profil yang disambungkan mempunyai tepat satu templat kad aktif. Jika berbilang templat aktif, pilih template_id yang betul daripada GET /templates.
Gunakan API untuk POS tersuai, hujung belakang, tapak atau kawalan penuh. Gunakan Make untuk senario percabangan visual. Gunakan Zapier untuk aliran kerja tindakan pencetus yang kebanyakannya linear. Ketiga-tiganya bergantung pada kunci API dan kontrak API yang sama.
Halaman berkaitan
Langkah seterusnya
Cipta kunci, hubungi GET /templates, buat satu jemputan untuk kenalan pakai buang, kemudian tambahkan rahsia pengeluaran, pengelogan, percubaan semula dan pengendalian webhook di sekitar permintaan yang terbukti.