Интеграция с разработчиками
7stamp Integration API позволяет CRM, платформе электронной коммерции, POS, пользовательскому серверу или инструменту автоматизации управлять картами лояльности кошелька с помощью контакта. идентификатор, который уже использует ваша собственная система. Это универсальный вариант, когда специализированной интеграции не существует.
База API URL — это https://api.7loc.com/cards-api. Аутентификация каждого запроса с помощью ключа API как токена Bearer. Используйте ссылку OpenAPI для схем активных запросов и ответов, прежде чем создавать производственную логику.
API сторона записи стека интеграции. Используйте его всякий раз, когда ваше собственное программное обеспечение должно оставаться оперативным источником правды, в то время как 7stamp отвечает за уровень лояльности кошелька.
Создайте ссылку на карту личного кошелька для любого клиента в вашей системе. Доставьте его по электронной почте, SMS, push-уведомлению или через приложение. Клиент открывает ссылку и сохраняет карту на Apple Wallet или Google Wallet.
Когда покупка закрывается в вашем таможенном номере POS, когда онлайн-заказ оплачивается на вашем веб-сайте или когда услуга оказывается в вашей системе бронирования, позвоните по номеру API, чтобы получить кредитные марки. Карта обновляется в течение нескольких секунд.
Выдавайте разовый ваучер конкретному клиенту, создавайте готовые потоки вознаграждений для кампании и возвращайте статус ваучера обратно в системы, которые управляют финансами и качеством обслуживания.
Это общедоступные API маршруты за Действия Make и Zapier. Прочтите точную схему в справочнике API; не выводите имена полей из другой конечной точки.
POST /cards/invite Создает новую личную установку URL для внешнего контакта.
POST /cards/invite/bulk Создает до 100 пригласительных ссылок в контролируемом пакете.
GET /cards Поиск записей карточек по внешнему идентификатору контакта.
GET /cards/{user_card_id} Возвращает полное состояние одной карты по ее внутреннему 7stamp ID.
POST /cards/scan Добавляет марки по карте ID или External ID и записывает исходный заказ при поставке.
GET /templates Перечисляет шаблоны карточек, доступных на рабочем месте ключа/profile.
GET /templates/{template_id}/design Считывает визуальные настройки для известных шаблон карты.
POST /vouchers/issue Выдает ваучер владельцу карты.
POST /messages/send Отправляет push-карту кошелька и /or содержимое электронной почты владельцу карты.
Это настоящие 7stamp Admin экраны. Откройте API и «Интеграции», добавьте ключ, затем скопируйте его в безопасное секретное соединение на стороне сервера или в автоматическое соединение.
Создайте ключ в 7stamp Admin под API Integrations → API Keys → Add API Key. Ключ принадлежит одному рабочему месту/profile, поэтому создавайте отдельные ключи для разработки и производства, если это позволяет настройка вашей учетной записи. Поменяйте или отзовите доступ к панели управления, если секрет раскрыт.
External ID — это постоянный идентификатор контакта в вашей системе: CRM ID, клиент UUID, номер телефона или адрес электронной почты. Предпочитайте неизменяемую систему ID. При желании добавьте External Source, чтобы избежать конфликтов между системами и сделать явную корреляцию веб-перехватчиков.
Если в профиле есть один активный шаблон, template_id можно опустить, а 7stamp выберет его автоматически. Если у него несколько активных шаблонов, передайте предполагаемый template_id. Сначала прочитайте GET /templates, а не жестко кодируйте угаданный 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
}'Войдите в систему 7stamp Admin и создайте ключ: API Integrations → API Keys → Add API Key. Храните его в своем секретном менеджере, а не в исходном коде или клиентском приложении.
Установите базовый URL на https://api.7loc.com/cards-api и добавьте Authorization: Bearer, за которым следует ключ для каждого запроса на стороне сервера.
Сначала позвоните по номеру GET /templates. Успешный ответ подтверждает токен и показывает шаблоны, доступные для этого рабочего места: 7639⟧
. Выберите стабильный External ID и дополнительный External Source из вашей собственной системы. Используйте одну и ту же пару идентификаторов в логике создания, сканирования, поиска и веб-перехватчика.
Позвоните на номер POST /cards/invite с помощью одноразового тестового контакта. Проверьте возвращенную установку URL перед автоматизацией доставки реальным клиентам.
Добавляйте POST /cards/scan, действия ваучера или сообщения только после того, как в вашем собственном бэкэнде реализована стратегия регистрации, обработки ошибок и безопасной повторной попытки/idempotency.
Публичная ссылка Swagger/OpenAPI содержит текущую конечную точку, параметр, тело запроса, ответ и схемы веб-перехватчика. Интерактивный URL — это https://api.7loc.com/cards-api/docs, а машиночитаемый контракт — https://api.7loc.com/cards-api/openapi.json.. Прочтите его перед выполнением обработки ошибок или добавлением необязательных полей.
Ключ представляет собой секрет на стороне сервера. Не раскрывайте его в JavaScript браузера, пакете мобильного приложения, общедоступной форме, снимках экрана, текстовых полях Make/Zapier или в обращениях в службу поддержки. Используйте сервер, безопасное соединение автоматизации или секретный менеджер. Если ключ когда-либо был случайно передан, отмените или поменяйте его в 7stamp Admin и обновите затронутое соединение.
В 7stamp Admin перейдите в API Integrations → API Keys → Add API Key. Затем токен отправляется в заголовке Authorization как Bearer, за которым следует ключ.
Используйте https://api.7loc.com/cards-api и отправляйте Authorization: Bearer YOUR_7STAMP_API_KEY при каждом авторизованном запросе.
Только если в подключенном профиле имеется ровно один активный шаблон карты. Если активно несколько шаблонов, выберите правильный template_id из GET /templates.
Используйте API для пользовательского POS, серверной части, сайта или полного контроля. Используйте Make для сценариев визуального ветвления. Используйте Zapier для преимущественно линейного рабочего процесса с триггерным действием. Все три используют один и тот же ключ API и контракт API.
Связанные страницы
Следующий шаг
Создайте ключ, позвоните по номеру GET /templates, создайте одно приглашение для одноразового контакта, затем добавьте производственные секреты, ведение журнала, повторные попытки и обработку веб-перехватчиков для подтвержденного запроса.