나누 공식 컨텐츠 연동
게임 내의 최고 기록 갱신 / 레어 아이템 획득 / 아이템 강화 성공 등 유저가 자랑할만한 이벤트가 발생 시 이를 공식적인 게시물 형태로 나누 커뮤니티에 자랑할 수 있습니다.
<설정 방법>
- 파트너스 홈 > 개발자 센터 > API Key 페이지에서 API Key 생성
- (선택) 파트너스 홈 > 게시판 관리 > 게시판 설정 페이지에서 공식 컨텐츠가 저장될 게시판 생성 (선택 안할 시 자유게시판으로 설정)
- (선택) 파트너스 홈 > 개발자 센터 > 공식컨텐츠 연동 페이지에서공식 컨텐츠에 사용될 이미지 등록
- (인게임) 공식 컨텐츠 작성을 위한 이벤트 발생 시 나누에 1회성 인증키 생성 호출
- 리턴받은 1회성 인증키와 공식 컨텐츠 문구, 보여질 이미지 등 필요한 값이 입력된 URL 주소로 웹 브라우저 호출
URL 정보
- 게임의 결과 (레벨,스코어) 등을 손쉽게 POST 할 수 있습니다.
[URL]
GET /게임채널아이디/share/web?key={access_key}&board={board_number}&content={content}&image={code} Host: game.nanoo.so Protocal: https
키 | 설명 | 기본값 | 필수 |
---|---|---|---|
key | API 통해 발급받은 일회성 인증키 | null | O |
board | 추가 설정 된 게시판 고유번호 (미설정 시 자유게시판으로 기본 세팅됨.) 게시판 설정은 { 게시판관리 > 게시판 설정 } 에서 가능함. | 0 | X |
content | 게시물 내용 (게임 결과 정보) ex)닉네임님 아름다운이별 SCORE 40,000점 달성 | null | O |
image | 이미지 설정에 등록 된 이미지 코드 (파트너스 홈 > 개발자센터 > 공식컨텐츠연동 페이지에서 관리) | null | X |
일회성 인증키 발급
- 공유하기 사용을 위하여 일회성 인증키를 발급.
- 사용되지 않은 일회성키는 60분후 자동 폐기됩니다.
[Request]
GET /v1/disposable/share?key={api_key}&content={content}&image={code} HTTP/1.1 Host: api.nanoo.so Protocal: https
키 | 설명 | 기본값 | 필수 |
---|---|---|---|
key | 게임채널에서 생성된 API 호출 KEY. | null | O |
content | 게시물 내용 (게임 결과 정보) * 일회용 인증 키 생성 시 게시물 내용을 추가 할 경우 URL정보의 content 파라미터 정보는 사용되지 않음. * 이벤트 및 특수한 목적 즉 데이터 유지가 필요한 상황에 사용 권장. | null | X |
image | 이미지 설정에 등록 된 이미지 코드 (파트너스 홈 > 개발자센터 > 공식컨텐츠연동 페이지에서 관리) * 일회용 인증 키 생성 시 이미지 코드를 첨부 할 경우 URL정보의 image 파라미터 정보는 사용되지 않음. * 이벤트 및 특수한 목적 즉 데이터 유지가 필요한 상황에 사용 권장. | null | X |
[Response]
응답은 JSON 형식으로 제공 됩니다.
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"result"
{
key: "wHv3D"
}
}