자동 지급 API
블리피에서 제공하는 게임에서 기프트/리워드 지급 대상자를 자동으로 처리하기 위한 API 안내 문서입니다. API 주소 등록 시, 기프트/리워드 지급 대상자의 목록과 지급 품목 등에 대한 정보를 등록한 [자동 지급 API 주소]로 전달받을 수 있습니다. 해당 기능을 사용하시려면 반드시 자동 지급 API 주소가 등록되어 있어야 합니다. 등록 방법은 [REST API > 시작하기] 페이지를 참고하세요.
프로모션 내에 직접 지급해야하는 실물 리워드(ex. 자사 쿠폰, 자사 포인트, 배송 상품, 기타)를 설정한 경우, 기프트/리워드 코드가 발급됩니다. 등록한 [자동 지급 API 주소]로 기프트/리워드를 지급받을 유저 정보와 코드 정보가 전달되고, 전송 결과에 따라 기프트/리워드 지급 처리가 완료됩니다. *기프트/리워드 코드 확인 방법 : [Client Admin] 진입 > 프로모션 관리 > 프로모션 상세 페이지 > [개발 정보 확인하기] 팝업 > 등록한 기프트/리워드 코드 확인
Request
Method | URL |
|---|---|
POST | API 사용 관리 페이지에 등록한 [자동 지급 API] 주소를 입력해주세요. |
본문
*code와 userKey는 전달 예시입니다.
Name | Type | Description |
|---|---|---|
key | String | 해당 api에서 key값은 list로 전달합니다. |
value | ArrayList<AutoPayment> | 객체 배열을 의미합니다. |
AutoPayment
Name | Type | Description |
|---|---|---|
code | String | 프로모션에 등록 된 기프트/리워드 연동 코드입니다.
연동 코드는 Client Admin > 프로모션 관리 > 프로모션 상세 페이지 > [개발 정보 확인하기] 팝업에서 확인할 수 있습니다. |
userKey | String | 게임에 참여한 user key 정보입니다. |
Response
요청 처리 정상
HTTP status code |
|---|
200 |
참고
자동 지급 처리는 List size가 항상 1입니다. 지급처리에 실패해, 수동으로 재시도 할 때 user key List는 50개씩 전달됩니다. (ex. 70건 지급처리 재시도 시, 50건 / 20건 으로 2번에 걸쳐 전송)
개발에 대한 추가 설명이 더 필요하신가요?
"[Client Admin] 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.
v1.0.7