Roamify eSIM API 주요 변경 사항에서 무엇을 배울 수 있나요?

eSIM 활성화 방법, 데이터 요금제 비교 방법, 여행 전과 여행 중에 가장 중요한 설정 단계에 대해 알아보세요.

일본에 적합한 eSIM 요금제를 선택하려면 어떻게 해야 하나요?

여행 기간, 일일 예상 데이터 사용량, 핫스팟 요구 사항, 목적지의 네트워크 품질에 맞춰 계획을 세우세요. 단기 체류에는 일반적으로 더 적은 데이터가 필요한 반면 원격 작업 및 화상 통화에는 더 많은 데이터가 필요합니다.

이 가이드의 목적지 링크를 사용하면 Roamify 국가 페이지로 직접 이동하고, 요금제 옵션을 비교하고, 출발 전에 결제를 완료할 수 있습니다.

eSIM 가이드·June 9, 2026 22:20

Donald Bogle

June 9, 2026 22:20

우리는 새로운 엔드포인트, 확장된 기능, 그리고 통합을 업데이트하기 전에 알아야 할 몇 가지 변경 사항을 포함한 API 업데이트 세트를 출시하고 있습니다.

엔드포인트: GET /api/esim/packages

이 엔드포인트는 이제 반환합니다 페이지 매김된 결과 모든 패키지를 단일 응답으로 받는 대신. 통합이 페이지 매김 매개변수 없이 패키지를 가져오는 경우, 결과의 첫 번째 페이지만 수신할 수 있습니다.

조치 필요: 페이지 매김된 응답을 처리하도록 통합을 업데이트하세요 page 및 pageSize 쿼리 매개변수를 사용하여.

매개변수	유형	기본값	설명
페이지	문자열	1	가져올 페이지 번호입니다.
페이지 크기	문자열	50	페이지당 결과 수입니다.

모든 패키지를 가져오려면, 응답이 페이지 크기보다 적은 결과를 반환할 때까지 페이지를 반복하세요.페이지 크기.

이전에는 이 필드들이 상호 교환적으로 사용되었을 수 있습니다. 이제는 다른 목적을 가지고 있으며 둘 다 에서 가져온 값을 사용해야 합니다.GET /api/esim/countries 엔드포인트 — 임의의 문자열은 더 이상 허용되지 않습니다.

매개변수	허용되는 값	출처
country	전체 국가 이름	Country API의 name 필드
countryCode	ISO 국가 코드	Country API의 code 필드

조치 필요: 현재 자유 텍스트 국가 문자열을 전달하고 있다면, 통합을 업데이트하여 먼저 GET /api/esim/countries 를 호출하고 응답에서 name 또는 code 값을 사용하세요.

Roamify eSIM이 지원하는 모든 국가의 목록을 반환합니다. 이 응답의 name 및 code 값을 필터 입력으로 사용하여 GET /api/esim/packages를 쿼리하세요.

선택적 필터 매개변수 사용 가능 지리

eSIM으로 직접 SMS 메시지를 보내세요.

이름	유형	필수	설명
iccid	string	required	SMS를 보낼 eSIM의 ICCID입니다.
message	string	required	보낼 메시지 내용입니다.

새로운 선택적 startDate 필드가 Generate eSIM Profile 엔드포인트에 추가되었습니다. 약간의 패키지 (~30개 중 28,000개 이상)에서는 이 필드가 필수입니다.

이 패키지들은 requirements.travelDate 가 true 패키지 객체에 있습니다. 필요하지만 제공되지 않으면 프로필 생성 요청이 실패합니다.

이름	유형	필수	설명
startDate	문자열	조건부	ISO 8601 형식의 여행 시작 날짜입니다. requirements.travelDate가 true인 경우 필수입니다.

/api/esim/apply를 호출할 때 요청 시간 초과를 최소 60초로 설정하는 것을 잊지 마세요.

전체 문서는 에서 확인할 수 있습니다.docs.getroamify.com.

질문이 있거나 통합 업데이트에 도움이 필요하면 파트너 지원 팀에 문의하세요.

Donald Bogle

June 9, 2026 22:20

AI로 요약하기