회원ID 또는 토큰으로 회원 정보 조회

API Description

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

Request Parameter

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 제휴 서비스 코드

Response Parameter

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 회원 이름
email 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 응답 결과 상세 설명

Response Code

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 값이 유효하지 않음.

Example

Request


            

Response