API 둘러보기
이용패턴으로 찾는요금제 추천이동전화 요금제 추천 API는
사용자의 이용패턴으로 가장 최적화 된
요금제에 대한 검색 결과를 전달하는 API 입니다.
목차
- 1. 소개
- 2. 요구사항
- 3. 트래픽 제한
- 4. 인증
- 5. 요청주소(Request URL)
- 6. 요청변수(Request Parameter)
- 7. 출력결과(Response Element)
- 8. 예제 URL
- 소개
-
이동전화 요금체 추천 검색 API는 스마트초이스에서 제공되는 데이터와 관련된 API 입니다. 본 API를 사용하시려면
먼저 요금제 추천 검색 API에 대한 인증키(apikey)를 발급 받아야 합니다.
모든 기능의 문자 인코딩 방식은 기본적으로 모두 UTF-8입니다.
- 요구사항
- XML 파싱능력
- 트래픽 제한
- 1개의 키에 대해 하루 10,000회 호출을 허용합니다.
OpenAPI는 스마트초이스 회원만 이용할 수 있으며, 인증키 발급 신청 후 스마트초이스에서 승인을 받으면 이용할 수 있습니다.
OpenAPI 이용 시에는 OpenAPI 키값이 필요하며, 이 키 값은 회원 아이디로만 이용하실 수 있습니다.
http://api.smartchoice.or.kr/openAPI.xml
요청변수 정보
요청변수 |
값 |
설명 |
authkey |
String (필수) |
인증키 |
voice |
String (필수) |
월 평균 통화량 (입력단위:분, 무제한:999999) |
data |
String (필수) |
월 평균 데이터 사용량 (입력단위:MB, 무제한:999999) |
sms |
String (필수) |
월 평균 문자 발송량 (입력단위:건, 무제한:999999) |
age |
String (필수) |
연령(성인:20, 청소년:18, 실버:65) |
type |
String (필수) |
서비스 타입(3G:2, LTE:3, 5G:6) |
dis |
String (필수) |
약정기간 (무약정:0, 12개월:12, 24개월:24) |
공통 헤더
공통 헤더 정보
출력변수 |
값 |
설명 |
resultCode |
String |
결과코드(인증키 없음:001, 10000회 초과:002, 그 외 오류:099, 성공:100) |
resultCount |
Int |
추천결과 갯수 |
resultdate |
String |
응답일시 |
데이터 부분
데이터 부분 정보
출력변수 |
값 |
설명 |
v_tel |
String |
이동통신사(SKT,KT,LGU+) |
v_plan_price |
String |
예상 금액 |
v_dis_price |
String |
약정할인금액 |
v_plan_over |
String |
기본 제공량 초과 사용량과 금액 |
v_add_name |
String |
요금제 기본료, 부가서비스 기본료 |
v_plan_name |
String |
요금제명, 부가서비스명 |
v_plan_display_voice |
String |
음성 기본제공량 |
v_plan_display_data |
String |
데이터 기본제공량 |
v_plan_display_sms |
String |
문자 기본제공량 |
rn |
String |
요금제 추천 구분(으뜸:1, 알뜰:2, 넉넉:3) |
http://api.smartchoice.or.kr/api/openAPI.xml?authkey=testkey&voice=100&data=300&sms=50&age=20&type=3&dis=24