사용자-역할-조회-roleid로-선택-사항

설명

원본 공장의 API 인터페이스를 요청하여 플레이어 캐릭터 정보를 가져옵니다.
이 인터페이스는 일반적으로 페이지 결제, 제3자 결제 및 보충 결제 전에 사용되며, 플레이어의 캐릭터 정보를 조회한 후 결제 작업을 수행합니다.
기본 매개변수에는: 캐릭터 ID(roleId), 현재 타임스탬프(timestamp), MD5 서명(sign)이 포함됩니다.
기능 도메인 이름은 원본 공장과 당사 제품의 협의에 따라 결정됩니다. sign 서명 안의 KEY 값은 기밀로 사용자 정의하면 되며, 원본 공장에서 제공합니다(예: 영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음).

처리 흐름도

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

http://xxxx.xxxxxx.com/role/info?roleId=3258506&timeStamp=1378456412008&sign=1faec808b862af2d5a726f993477529b

요청 매개변수

매개변수 설명
roleId	캐릭터 ID	필수
timestamp	타임스탬프 [초 단위로 정확함]	필수
sign	서명 암호화 규칙 MD5(roleId+캐릭터KEY+timestamp) 캐릭터 KEY: 양측이 사전에 합의한 기밀 값(예: 영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음)	필수

반환 결과

반환 결과(표준 JSON 형식)
성공	{"ret":0,"msg":"ok","data":{"userid":"3520001","roleName":"캐릭터1","serverName":"서버1","serverId":"1001","level":30}}	ret:0 수신 성공
실패	{"ret":1001, "msg":"매개변수 오류"}	ret이 0이 아니면 오류, 참고: 오류 코드 설명이 정의된 경우 알려주시기 바랍니다

반환 JSON 필드

반환 매개변수 설명
ret	반환 상태	필수 반환
msg	반환 정보 설명	필수 반환 ; (주의: 반환 msg는 오류 원인을 정확하게 설명하는 것을 권장하며, userId 오류 시에도 system busy 원인을 사용하는 것을 권장하지 않음)
data	캐릭터 정보 본문 배열 형식, 예: "data":{"userid":"3520001","roleName":"캐릭터1","serverName":"서버1","serverId":"1001","level":30}	ret이 0이 아님(실패 시)-반환 불필요
userid	캐릭터에 해당하는 플랫폼 사용자 id(캐릭터 존재 시 필수 반환)	ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요
roleName	캐릭터 이름(캐릭터 존재 시 필수 반환)	ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요
serverId	서버 ID(캐릭터 존재 시 필수 반환) 주의: 벤더 serverId는 당사와 합의된 서버 serverCode에 해당해야 하며, 그렇지 않으면 검증에 실패합니다	ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요
serverName	서버 이름(캐릭터 존재 시 필수 반환)	ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요
level	캐릭터 레벨(캐릭터 존재 시 필수 반환)	ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요

오류 코드

귀하가 사용자 정의하며, ret이 0이 아니면 모두 오류 코드입니다.