매일 미션 API

블리피 육성게임에서 Action 타입의 매일 미션 사용 시 미션 완료에 대한 결과를 처리하는 API 문서입니다. 해당 API 문서를 확인하여 개발을 진행해 주세요.

프로모션 등록 시 매일 미션을 설정하면 미션 코드가 발급됩니다. 발급된 미션 코드는 미션 생성 시 설정된 이동링크(딥링크)에 포함되어 클라이언트 서비스로 전송됩니다.

전송된 미션 코드를 확인하기 위한 개발은 매일 미션 페이지에서 확인할 수 있습니다.

• 미션 코드 확인 방법

  • [Client Admin] 로그인 > 프로모션 상세 페이지 > Action 미션의 [미션 조회/수정] 팝업 > 등록한 미션의 미션코드 확인

---

해당 API는 클라이언트 서버 -> 블리피 서버로 요청됩니다.

Request

Method	URL
POST	https://open-client-api.bleepy.io/api/open-client/mission-result

Header

Name	Type	Description	Required
API-Key	String	인증을 위한 API 키 정보	O

Body

Name	Type	Description	Required
missionCode	String	미션을 등록하면 발급되는 미션 코드입니다.	O
userKey	String	미션을 수행한 userKey 정보	O
participationDateTime	String	미션 참여 시간 (yyyy.MM.dd HH:mm:ss) UTC기준	O

// Body Example
{
    "missionCode": "미션코드 입력",
    "userKey": "유저키",
    "participationDateTime": "2025.02.17 15:30:31"
}

Response

요청 처리 정상

HTTP status code
200

에러 본문

Name	Type	Description	Required
type	String	고정 값	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 키가 유효하지 않은 경우	401
OE003	IP 주소가 유효하지 않은 경우	403
OE004	미션의 일별 참여 횟수를 초과할 경우	400
OE005	미션 타입이 유효하지 않은 경우	400
OE006	미션 수행 시간이 유효하지 않은 경우	400
OE007	미션코드가 유효하지 않은 경우	400
OE008	userKey가 유효하지 않은 경우	400

개발에 대한 추가 설명이 더 필요하신가요?

"[Client Admin] 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.