이용자-캐릭터-api-조회-필요
설명
원본 공장의 API 인터페이스를 요청하여 플레이어 캐릭터 정보를 가져옵니다.
이 인터페이스는 일반적으로 페이지 결제, 제3자 결제 및 보충 결제 전에 사용되며, 플레이어의 캐릭터 정보를 조회한 후 결제 작업을 수행합니다.
기본 매개변수에는: 사용자 ID(userId), 서버 CODE(serverCode), 현재 타임스탬프(timestamp), MD5 서명(sign)이 포함됩니다.
기능 도메인 이름은 원본 공장과 당사 제품의 협의에 따라 결정됩니다. sign 서명 안의 KEY 값은 기밀로 사용자 정의하면 되며, 원본 공장에서 제공합니다(예: 영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음).처리 흐름도
요청 URL(post 및 get 방식 지원 필요, POST 우선 권장)[기본 application/x-www-form-urlencoded] 도메인 경로(벤더 제공 필요) 예: http://xxxx.xxxxxx.com/user/info 테스트 서버 링크 예:
java
http://xxxx.xxxxxx.com/user/info?userId=3258506&serverCode=1×tamp=1378456412008&sign=1faec808b862af2d5a726f993477529b요청 매개변수
| 매개변수 설명 | ||
|---|---|---|
| userId | 사용자 ID | 필수 |
| serverCode | 결제 서버 CODE | 필수 |
| timestamp | 타임스탬프 [초 단위로 정확함] | 필수 |
| sign | 서명 암호화 규칙 MD5(userId+serverCode+캐릭터KEY+timestamp) 캐릭터 KEY: 양측이 사전에 합의한 기밀 값(예: 영문 대소문자 또는 숫자로 구성된 8~32자이며 특수문자는 포함하지 않음) | 필수 |
반환 결과
| 반환 결과(표준 JSON 형식) | ||
|---|---|---|
| 성공 | {"ret":0,"msg":"ok","data":[{"roleId":120,"level":30,"nick":"캐릭터1"},{"roleId":123,"level": 31,"nick":"캐릭터2"}]} | ret:0 수신 성공 |
| 실패 | {"ret":1001, "msg":"매개변수 오류"} | ret이 0이 아니면 오류, 참고: 오류 코드 설명이 정의된 경우 알려주시기 바랍니다 |
반환 JSON 필드
| 반환 매개변수 설명 | ||
|---|---|---|
| ret | 반환 상태 | 필수 반환 |
| msg | 반환 정보 설명 | 필수 반환 ; (주의: 반환 msg는 오류 원인을 정확하게 설명하는 것을 권장하며, userId 오류 시에도 system busy 원인을 사용하는 것을 권장하지 않음) |
| data | 캐릭터 정보 본문 배열 형식, 예: "data":[{"roleId":120,"level":30,"nick":"캐릭터1"},{"roleId":123,"level":31,"nick":"캐릭터2"}] | ret이 0이 아님(실패 시)-반환 불필요 |
| roleId | 캐릭터 ID(캐릭터 존재 시 필수 반환) | ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요 |
| nick | 캐릭터 이름(캐릭터 존재 시 필수 반환) | ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요 |
| level | 캐릭터 레벨(캐릭터 존재 시 필수 반환) | ret이 0일 때-필수 반환 ret이 0이 아님(실패 시)-반환 불필요 |
오류 코드
1001 매개변수 오류 1002 존재하지 않는 사용자 1003 sign 오류 1008 계정이 비활성화됨 65535 서버 오류