자신의 소프트웨어에서 카드를 발행하십시오.
시스템의 모든 고객을 위한 개인 지갑 카드 링크를 생성하십시오. 자신의 이메일, SMS, 푸시 또는 인앱 흐름을 통해 전달하세요. 고객은 링크를 열고 카드를 Apple Wallet 또는 Google Wallet에 저장합니다.
개발자 통합
7stamp REST API
사용 가능7stamp Integration API를 사용하면 CRM, 전자상거래 플랫폼, POS, 사용자 정의 백엔드 또는 자동화 도구가 시스템에서 이미 사용하고 있는 연락처 식별자를 사용하여 지갑 충성도 카드를 관리할 수 있습니다. 전문화된 통합이 존재하지 않는 경우 보편적인 옵션입니다.
API 기반 URL는 https://api.7loc.com/cards-api.입니다. API 키를 사용하여 Bearer 토큰으로 모든 요청을 인증합니다. 프로덕션 로직을 구축하기 전에 실시간 요청 및 응답 스키마에 대해 연결된 OpenAPI 참조를 사용하세요.
API로 수행할 수 있는 작업
API는 통합 스택의 쓰기 측입니다. 7stamp가 지갑 충성도 계층을 처리하는 동안 자체 소프트웨어가 운영 진실의 소스를 유지해야 할 때마다 이를 사용하십시오.
모든 소스의 신용 스탬프
맞춤형 POS에서 구매가 종료되거나, 웹 사이트에서 온라인 주문이 결제되거나, 예약 시스템에서 서비스가 완료되면 API를 호출하여 신용 스탬프를 받으세요. 카드는 몇 초 안에 업데이트됩니다.
바우처 및 캠페인 관리
특정 고객에게 일회성 바우처를 발행하고, 캠페인 준비 보상 흐름을 만들고, 바우처 상태를 금융 및 서비스 품질을 처리하는 시스템으로 다시 가져옵니다.
문서화된 통합 API 작업
이는 Make 및 Zapier 작업 뒤에 있는 공개 API 경로입니다. 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 메시지 보내기
지갑 카드 푸시 및 /or 이메일 콘텐츠를 카드 소유자에게 보냅니다.
API 키를 생성하고 복사하는 위치
실제 7stamp Admin 화면입니다. API & Integrations를 열고 키를 추가한 다음 보안 서버 측 비밀 또는 자동화 연결에 복사하세요.
Three decisions to make before coding
API 키 범위
코딩하기 전에 세 가지 결정을 내려야 합니다. API Integrations → API Keys → Add API Key 아래의 7stamp Admin에 키를 생성합니다. 키는 하나의 작업장/profile에 속하므로 계정 설정에서 허용하는 경우 개발용과 생산용으로 별도의 키를 생성하세요. 비밀이 노출된 경우 대시보드에서 액세스를 순환하거나 취소하세요.
고객 ID
External ID는 시스템의 안정적인 연락처 식별자입니다(CRM ID, 고객 UUID, 전화번호 또는 이메일). 불변 시스템 ID를 선호합니다. 선택적으로 External Source를 추가하여 시스템 간 충돌을 방지하고 웹훅 상관 관계를 명시적으로 만듭니다.
템플릿 선택
프로파일에 하나의 활성 템플릿이 있는 경우 template_id를 생략할 수 있으며 7stamp가 이를 자동으로 선택합니다. 활성 템플릿이 여러 개인 경우 의도한 template_id를 전달합니다. 추측된 ID를 하드 코딩하는 대신 GET /templates를 먼저 읽으십시오.
최소 인증 요청: 초대 만들기
이를 자동화 단계에 복사하십시오.
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
}'API 키에서 첫 번째 성공적인 요청까지
7stamp Admin에 로그인하고 키 API Integrations → API Keys → Add API Key를 만듭니다. 소스 코드나 클라이언트 측 애플리케이션이 아닌 Secret Manager에 저장하세요.
기본 URL를 https://api.7loc.com/cards-api로 설정하고 Authorization: Bearer 뒤에 키를 모든 서버측 요청에 추가합니다.
먼저 GET /templates를 호출하십시오. 성공적인 응답은 토큰을 확인하고 해당 작업장에서 사용할 수 있는 템플릿을 표시합니다./profile.
자체 시스템에서 안정적인 External ID 및 선택적 External Source를 선택합니다. 생성, 검색, 조회 및 웹훅 논리에 정확히 동일한 ID 쌍을 사용하세요.
일회용 테스트 접점을 사용하여 POST /cards/invite를 호출합니다. 실제 고객에게 자동으로 전달하기 전에 반환된 설치 URL를 확인하세요.
자체 백엔드에서 로깅, 오류 처리 및 안전한 재시도/idempotency 전략을 수행한 후에만 POST /cards/scan, 바우처 또는 메시지 작업을 추가하세요.
API 참조를 계약으로 사용
공개 Swagger/OpenAPI 참조에는 현재 엔드포인트, 매개변수, 요청 본문, 응답 및 웹훅 스키마가 포함되어 있습니다. 대화형 URL는 https://api.7loc.com/cards-api/docs이고 기계 판독 가능 계약은 https://api.7loc.com/cards-api/openapi.json.입니다. 오류 처리를 구현하거나 선택적 필드를 추가하기 전에 읽어보십시오.
인증 및 키 안전
키는 서버측 비밀입니다. 브라우저 JavaScript, 모바일 앱 번들, 공개 양식, 스크린샷, Make/Zapier 텍스트 필드 또는 지원 티켓에 노출하지 마세요. 서버, 보안 자동화 연결 또는 비밀 관리자를 사용하세요. 키가 실수로 공유된 경우 7stamp Admin에서 키를 취소하거나 순환하고 영향을 받는 연결을 업데이트하세요.
자주 묻는 질문
7stamp API 토큰은 어디서 얻을 수 있나요?
7stamp Admin에서 API Integrations → API Keys → Add API Key로 이동하십시오. 그런 다음 토큰은 Authorization 헤더에 Bearer와 키가 함께 전송됩니다.
기본 URL 및 인증 방법은 무엇입니까?
https://api.7loc.com/cards-api를 사용하고 승인된 각 요청에 대해 Authorization: Bearer YOUR_7STAMP_API_KEY를 보냅니다.
언제 template_id를 생략할 수 있습니까?
연결된 프로필에 정확히 하나의 활성 카드 템플릿이 있는 경우에만 해당됩니다. 여러 템플릿이 활성화된 경우 GET /templates.
Should I use the API, Make, or Zapier?
사용자 정의 POS, 백엔드, 사이트 또는 전체 제어를 위해 API를 사용하십시오. 시각적 분기 시나리오에는 Make를 사용하십시오. 대부분 선형적인 트리거-작업 워크플로우에는 Zapier를 사용하십시오. 세 가지 모두 동일한 API 키와 API 계약을 사용합니다.
다음 단계
가장 작은 안전 API 흐름을 먼저 테스트합니다.
키를 생성하고 GET /templates를 호출하고 일회용 연락처에 대한 하나의 초대를 생성한 다음 입증된 요청에 대한 프로덕션 비밀, 로깅, 재시도 및 웹후크 처리를 추가합니다.