API 문서
전체 API
서비스
약관 목록 조회동기
버전: v1
버전: v1
/api/v1/user/terms/all
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
termsList
array of objects
필수
약관 목록
termsList_item
object
옵션
tcId
number
필수
최소 : 1 , 최대 : 9999999999999999999
약관 ID
tcActionType
string
옵션
최소 : 1 , 최대 : 255
약관 용도 타입
- PY : 개인 정보 수집
- UNDER_14 : 만 14세 미만
- COUPON_SHOP : 쿠폰샵
- EZWEL : 복지몰
- OPEN_BANK : 오픈뱅킹
- OPEN_BANK_SPECIFIC : 오픈뱅킹 출금/조회
- MKT_NOTI : 마케팅 수신
- DEDUCT : 자동소득공제
title
string
필수
최소 : 1 , 최대 : 255
약관 명
url
string
필수
최소 : 1 , 최대 : 255
약관 URL
required
string
필수
최소 : 1 , 최대 : 255
약관 필수 구분
- MANDATORY : 필수
- OPTIONAL : 필수 아님
order
string
필수
최소 : 1 , 최대 : 8
약관 순서
isAgree
boolean
필수
회원 동의 여부
요청 "userId"가 있는 경우 :
- 회원이 동의한 약관의 경우 true, 동의하지 않은 약관의 경우 false
요청 "userId"가 없는 경우 :
- false
agreeDate
string
옵션
길이 : 17
회원 약관 동의 일자
- 형식 : yyyyMMddHHmmssSSS
- 요청 "userId"가 있는 경우에 사용됩니다.
viewPositionType
string
옵션
최소 : 1 , 최대 : 20
약관 노출 시점
- OPEN_BANKING : 오픈 뱅킹 시점
- USER_PORTAL_CARD : 카드관리사이트 이용 시점
- NULL : 회원 가입 시점
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.
