버전

변경 내역

API 버전은 /v1 경로로 구분합니다. 호환되지 않는 변경은 새 경로를 사용하며 웹훅은 별도 버전입니다. 현재 명세: v2.4.0.

v2.4.0최신

추가OpenAPI 권한이 있는 회원은 api-testing.tongkhoesim.com에서 tke_member_test_ 키, 가상 잔액, 모의 주문/eSIM, 샘플과 시나리오를 사용할 수 있습니다. 키 관리는 실제/테스트를 분리하며 테스트 데이터는 실제 지갑, 내역, 등급, 청구서에 영향을 주지 않습니다.
참고회원 대량 주문과 웹훅은 지원되지 않습니다. 환불 심사는 실제 모드 전용이며 테스트 취소는 가상 잔액으로 환불됩니다. 회원 seed/reset에는 Idempotency-Key, reset에는 reason이 필요합니다. 테스트는 실제 공급자를 호출하거나 실제 MISA 청구서를 발행하지 않습니다.

v2.3.0안정

추가관리자가 승인한 일부 회원은 실제 Open API 키를 사용할 수 있습니다. 주문, 지갑, 환불, 청구서는 계속 회원 소유로 유지됩니다. 합의된 개별 가격은 최종 가격이며 등급 할인을 다시 적용하지 않습니다.
참고회원용 GET/POST /v1/esims/{id}/refund-requests와 회원 주문의 선택 항목 invoice_buyer를 추가했습니다. 구매자를 생략하면 기존 소비자 청구서 절차를 유지합니다. 일괄 주문, 웹훅, 테스트 모드는 조직 전용이며 회원은 capability.not_supported를 받습니다.

v2.2.0안정

추가eSIM 웹훅(esim.delivered, esim.activated, esim.usage_threshold, esim.expiring)에 order_id 및 external_ref가 포함되어 추가 호출 없이 주문을 연결합니다.
추가GET /v1/esims, GET /v1/esims/{id}, items[]에 external_ref가 추가됩니다. ?external_ref=…로 주문의 eSIM을 조회하고 ?iccid=…로 id를 찾습니다.
추가POST /v1/testmode/esims/{id}/simulate의 status enabled는 운영과 같이 esim.activated를 정확히 한 번 보냅니다.
참고/v1/catalog/packages 가격은 계약별 가격을 포함하여 실제 조직 결제 금액과 같습니다.
참고기존 필드 변경이나 삭제 없이 추가만 했습니다. external_ref는 항상 있으며 미입력 시 null입니다.

v2.1.0안정

추가조직 공급사 범위가 카탈로그, 상세, 주문, plan-options를 제한합니다. 범위 밖은 partner.package_not_visible / order.package_not_allowed입니다. filtered_by_provider_scope 경고와 범위 내 SKU만 포함한 catalog.updated를 제공하며 공급사는 노출하지 않습니다.
참고범위가 지정되지 않은 조직은 기존과 동일합니다.

v2.0.0안정

추가/v1 응답 통일: {items, next_cursor, page_size, total, mode, warnings[]}, 개체별 id, 금액 {amount, currency}, usage{}, ?include=lpa 설치 정보, cancellable{allowed,reason,disclosed_at}. topup-options/topup은 plan-options/change-plan으로 변경.
추가테스트: api-testing.tongkhoesim.com/tke_test_, 운영: tke_live_. 호스트 오류는 403 partner.wrong_host입니다. /v1/testmode/*에 status, seed, reset, esims/{id}/simulate, webhooks/fire, webhooks/fail-next가 추가되며 첫 키 샘플 및 자동 사용량을 제공합니다.
참고이 버전 이전에는 연동 파트너가 없었으며 이 버전부터 계약을 안정화합니다.