아이템-지급-사전등록-보상-약속-코드

설명

원본 공장의 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	양측 합의 사전 등록 유형, 예: 0	필수
elementId	양측 합의 사전 등록 보상 번호, 예: 99999	필수
count	양측 합의 사전 등록 아이템 지급 수량, 예: 1	필수
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 서버 오류