아이템-api-지급-선택

설명

원본 공장의 API 인터페이스를 요청하여 플레이어 캐릭터에 아이템을 지급하는 작업을 수행합니다.
이 인터페이스는 게임의 모든 결제 채널에서 아이템 지급 작업에 사용됩니다.
기본 매개변수에는: 아이템 유형(elementType), 아이템 번호(elementId), 아이템 수량(count), 플랫폼 ID(userId), 메일 제목(title), 메일 내용(content), 서버 CODE(serverCode), 현재 타임스탬프(timeStamp), MD5 서명(sign)이 포함됩니다.
기능 도메인 이름은 원본 공장과 당사 제품의 협의에 따라 결정됩니다. sign 서명 안의 KEY 값은 원본 공장에서 제공합니다(예: 영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음).

처리 흐름

요청 URL(post 및 get 방식 지원 필요, POST 우선 권장)[기본 application/x-www-form-urlencoded] 도메인 경로(벤더 제공 필요) 예: http://xxx.xxx.com/user/sendProps 테스트 서버 링크 예:

http://xxx.xxx.com/user/sendProps?elementType=1&elementId=0&userId=3258506&count=1&serverCode=ld4&timeStamp=1378456412008&roleId=12045897&sign=1faec808b862af2d5a726f993477529b&title=abc&content=12334

요청 매개변수

매개변수 설명
serverCode	서버 CODE	필수
userId	사용자 ID	필수
elementType	지급 아이템 유형 예: elementType:카드=1 금화=3장비=5 카드권=7신철=6 다이아몬드=9영웅=8 정수=12영웅혼=10 오더스트=13카드혼=14 드래곤블러드=16	선택
elementId	지급 아이템 번호[해당 데이터에서 조회 가능] 예: elementType이 카드, 장비, 신철, 카드혼, 영웅, 영웅혼일 때 elementId는 아이템 번호, 다른 유형일 때는 elementId를 0으로 입력	필수
count	지급 아이템 수량	필수
timeStamp	타임스탬프 [초 단위로 정확함]	필수
sign	서명 MD5(serverCode + userId + elementType + elementId + count + 이벤트KEY+ timeStamp), 이벤트 KEY는 영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음	필수
title	메일 제목	선택
content	메일 내용	선택
roleId	캐릭터 ID	선택

반환 결과

반환 결과(표준 JSON 형식)
성공	{"ret":0, "msg":"ok"}	ret:0 수신 성공
실패	{"ret":1001, "msg":"매개변수 오류"}	ret이 0이 아니면 오류, 참고: 오류 코드 설명이 정의된 경우 알려주시기 바랍니다

반환 JSON 필드

매개변수 설명
ret	반환 상태	필수 반환
msg	반환 정보 설명	필수 반환

오류 코드

1001 매개변수 오류 1002 존재하지 않는 사용자 1003 sign 오류 1004 중복 제출 1008 계정이 비활성화됨 65535 서버 오류