| Doc. No. | A1S2V1 | ||
|---|---|---|---|
| API Title | 회원 > 회원 정보 조회 | ||
| API Description | 서비스에 가입되어 있는 회원 정보를 조회합니다. | ||
| Protocol | HTTP | Interface Type | SYNC |
| HTTP METHOD | POST | Request URL | /api/v1/user/info |
| Data Encryption | Request : YES / Response : YES | ||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| userId | NUMBER | 1~999999999999 | MANDATORY | 회원 ID - 회원가입 시 부여되는 회원의 고유 ID입니다. |
||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| userInfo | OBJECT | MANDATORY | 회원 정보 | |||
| └ aspId | STRING | 15 | MANDATORY | ASP ID - 서비스 사업자에게 부여한 ID입니다. - ID는 계약 시 제공됩니다. |
||
| └ userId | NUMBER | 0~999999999999 | MANDATORY | 회원 ID - 회원가입 시 부여되는 회원의 고유 ID입니다. |
||
| └ birthDate | STRING | 8 | MANDATORY | 회원 생년월일 - 형식 : yyyyMMdd |
||
| └ ci | STRING | 88 | MANDATORY | CI(Connection Information) - 서비스 중복 가입 또는 외부 서비스 연계 시 개인을 식별하기 위한 정보로서 통신사 본인인증 등을 통해 얻을 수 있습니다. - 외부 서비스와의 연동이 필요없는 서비스 사업자의 경우에는 별도의 개인을 식별 값을 부여하여 사용 가능 합니다. |
||
| └ loginId | STRING | 1~80 | MANDATORY | 회원 로그인 ID - 중복될 수 없습니다. |
||
| └ nationality | STRING | 6~9 | MANDATORY | 회원 국적 - Korean - Foreigner |
||
| └ gender | STRING | 4~6 | MANDATORY | 회원 성별 - Male - Female |
||
| └ mobileNumber | STRING | 10~20 | MANDATORY | 회원의 휴대전화번호 | ||
| └ userName | STRING | 1~100 | MANDATORY | 회원 이름 | ||
| STRING | 1~50 | MANDATORY | (회원) 이메일 | |||
| └ joinChannel | STRING | 1~20 | OPTIONAL | 서비스 구분 코드 - 회원 가입을 요청하는 서비스를 구분하는 코드 입니다. - 예; OPENAPI, KONA, JADU, PINO, HEALTH |
||
| └ 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 : 거래 거절 |
||
| └ commId | STRING | 1~10 | OPTIONAL | 회원의 통신사 코드 본인인증 업체에서 관리하고 있는 값으로, 추후 목록이 추가될 수 있음 - SKT : SKT 통신사 - LGT : LGT 통신사 - KTF : KT 통신사 - SKR : SKT 알뜰 통신망 통신사 - KTR : KT 알뜰 통신망 통신사 - LGR : LGT 알뜰 통신망 통신사 |
||
| 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 | 회원을 찾을 수 없습니다. |