| Doc. No. | A1S23V1 | ||
|---|---|---|---|
| API Title | 회원 > 회원ID 또는 토큰으로 회원 정보 조회 | ||
| API Description | 서비스에 가입되어 있는 회원 정보를 조회합니다. userId 또는 userId를 변환한 임시토큰값인 tokenId 값을 입력해야 하고, userId와 tokenId가 동시에 입력된 경우, userId값을 우선으로 사용합니다. |
||
| Protocol | HTTP | Interface Type | SYNC |
| HTTP METHOD | POST | Request URL | /api/v1/user/info/userId |
| Data Encryption | Request : YES / Response : YES | ||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| userId | NUMBER | 1~999999999999 | CONDITIONAL | 회원 ID - 회원가입 시 부여되는 회원의 고유 ID입니다. - tokenId가 null 인 경우 필수 |
||
| tokenId | STRING | 19 | CONDITIONAL | 회원 토큰 ID - 회원ID의 임시 토큰 값 - userId가 null인 경우 필수 |
||
| serviceCode | STRING | 10 | MANDATORY | 제휴 서비스 코드 | ||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| userInfo | OBJECT | MANDATORY | 회원 정보 | |||
| └ aspId | STRING | 15 | OPTIONAL | ASP ID - 서비스 사업자에게 부여한 ID입니다. - ID는 계약 시 제공됩니다. |
||
| └ userId | NUMBER | 0~999999999999 | OPTIONAL | 회원 ID - 회원가입 시 부여되는 회원의 고유 ID입니다. |
||
| └ birthDate | STRING | 8 | OPTIONAL | 회원 생년월일 - 형식 : yyyyMMdd |
||
| └ ci | STRING | 88 | OPTIONAL | CI - Connection Information - 서비스 중복 가입 또는 외부 서비스 연계 시 개인을 식별하기 위한 정보로서 통신사 본인인증 등을 통해 얻을 수 있습니다. - 외부 서비스와의 연동이 필요없는 서비스 사업자의 경우에는 별도의 개인을 식별 값을 부여하여 사용 가능 합니다. |
||
| └ loginId | STRING | 1~80 | OPTIONAL | 회원 로그인 ID - 중복될 수 없습니다. |
||
| └ nationality | STRING | 6~9 | OPTIONAL | 회원 국적 - Korean - Foreigner |
||
| └ gender | STRING | gender | OPTIONAL | 회원 성별 - Male - Female |
||
| └ mobileNumber | STRING | 10~20 | OPTIONAL | 회원의 휴대전화번호 | ||
| └ userName | STRING | 1~100 | OPTIONAL | 회원 이름 | ||
| STRING | 1~50 | OPTIONAL | (회원) 이메일 | |||
| └ addressInfo | OBJECT | OPTIONAL | 회원 주소 정보 | |||
| └ zipCode | STRING | 5~6 | MANDATORY | 우편 번호 | ||
| └ address | STRING | 1~255 | MANDATORY | 주소 | ||
| └ addressDetail | STRING | 1~255 | OPTIONAL | 상세 주소 | ||
| └ status | STRING | 6~20 | MANDATORY | 회원 상태 - ACTIVE : 정상 - DELETED : 탈퇴 - SUSPENDED : 정지 - DORMANCY : 휴면 - REGISTERED : 가입단계 - REJECT : 거래 거절 |
||
| response | OBJECT | MANDATORY | 응답 결과 값 | |||
| └ code | STRING | 1~7 | MANDATORY | 응답 결과 코드 | ||
| └ description | STRING | 1~255 | MANDATORY | 응답 결과 상세 설명 | ||
| HTTP Status | Error code | Message | Description |
|---|---|---|---|
| 프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다. | |||
| 400 | 001_006 | Wallet user not found | 회원을 찾을 수 없습니다. |
| 400 | 001_090 | User did not agree to provide information. | 회원이 정보 제공 동의를 하지 않았음. |
| 400 | 001_091 | Affiliate service info not found. | 제휴사 서비스 정보를 찾을 수 없습니다. |
| 400 | 001_092 | Affiliate service status is invalid. | 제휴사 서비스 상태가 유효하지 않습니다. |
| 400 | 001_093 | Invalid tokenId. | tokenId 값이 유효하지 않음. |