매일 미션 API
블리피에서 제공하고 있는 게임에서 매일 미션을 사용하기 위한 API 문서입니다. 매일 미션의 Action 타입에 대한 API 문서로 미션 수행 완료에 대한 결과를 처리하는 API입니다. 발급된 API Key를 헤더에 설정하신 후 해당 API 문서를 확인하여 개발을 진행해 주세요.
프로모션 등록 시 매일 미션을 설정하면 미션 코드가 발급됩니다. 발급된 미션 코드는 미션에 설정된 Deep Link에 포함되어 런처에서 클라이언트 앱으로 전송됩니다. 전송된 미션 코드를 확인하기 위한 개발은 [매일 미션 > 설정하기] 페이지에서 확인할 수 있습니다. *미션 코드 확인 방법 : [Client Admin] 진입 > 프로모션 등록 > 프로모션 상세 페이지 > Action 미션의 [미션 조회/수정] 팝업 > 등록한 미션의 미션코드 확인
Request
Method | URL |
|---|---|
POST | https://open-client-api.bleepy.io/api/open-client/mission-result |
본문
Name | Type | Description | Required |
|---|---|---|---|
missionCode | String | 미션을 등록하면 발급되는 미션 코드입니다. | O |
userKey | String | User Key
게임 참여 이력이 있는 User Key입니다. | O |
participationDateTime | Data | 미션 참여 시간 (yyyy.MM.dd hh24:mi:ss)
UTC기준으로 입력해야 합니다. | O |
Response
요청 처리 정상
HTTP status code |
|---|
200 |
에러 본문
Name | Type | Description | Required |
|---|---|---|---|
type | String | about:blank 고정 값 | O |
title | String | 에러 요약 | O |
status | String | HTTP status code | O |
detail | String | 에러 메시지 | O |
instance | String | url | O |
errorCode | String | 에러 코드 | O |
에러 코드(errorCode) 종류
Code | Description | HTTP status code |
|---|---|---|
001 | 서버 내부 에러 | 500 |
003 | 입력 데이터 포맷이 잘못된 경우 | 400 |
OE001 | 인증 실패 | 401 |
OE002 | API Key가 유효하지 않은 경우 | 401 |
OE003 | IP 주소가 유효하지 않은 경우 | 403 |
OE004 | 미션의 일별 참여 횟수를 초과할 경우 | 400 |
OE005 | 미션 타입이 유효하지 않은 경우 | 400 |
OE006 | 미션 수행 시간이 유효하지 않은 경우 | 400 |
OE007 | 미션코드가 유효하지 않은 경우 | 400 |
OE008 | User Key가 유효하지 않은 경우 | 400 |
개발에 대한 추가 설명이 더 필요하신가요?
"[Client Admin] 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.
v1.0.6