Roamify eSIM API การเปลี่ยนแปลงที่สำคัญ
Donald Bogle
June 9, 2026 22:20
เรากำลังเปิดตัวชุดการอัปเดต API ที่นำจุดสิ้นสุดใหม่ ฟังก์ชันการทำงานที่ขยายออก และการเปลี่ยนแปลงบางอย่างที่คุณควรทราบก่อนที่จะอัปเดตการรวมของคุณ.
⚠️ การเปลี่ยนแปลงที่สำคัญ — รับ eSIM Packages #
จุดสิ้นสุด: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. การตอบสนองตอนนี้มีการแบ่งหน้า #
จุดสิ้นสุดนี้ตอนนี้ส่งคืน ผลลัพธ์ที่แบ่งหน้า แทนที่จะเป็นแพ็คเกจทั้งหมดในคำตอบเดียว หากการรวมของคุณดึงแพ็คเกจโดยไม่มีพารามิเตอร์การแบ่งหน้า คุณอาจได้รับเพียงหน้าผลลัพธ์แรกเท่านั้น.
ต้องดำเนินการ: อัปเดตการรวมของคุณเพื่อจัดการกับการตอบสนองที่แบ่งหน้าโดยใช้ page และ pageSize พารามิเตอร์การค้นหา.
| พารามิเตอร์ | ประเภท | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
| หน้า | สตริง | 1 | หมายเลขหน้าที่จะดึงข้อมูลมา. |
| ขนาดหน้า | สตริง | 50 | จำนวนผลลัพธ์ต่อหน้า. |
เพื่อดึงข้อมูลแพ็คเกจทั้งหมด ให้ทำการวนรอบหน้าจนกว่าการตอบกลับจะส่งผลลัพธ์น้อยกว่าที่คุณ ขนาดหน้า.
2. ประเทศ และ รหัสประเทศ ตอนนี้มีความหมายที่แตกต่างกัน #
ก่อนหน้านี้ฟิลด์เหล่านี้อาจถูกใช้แทนกันได้ ตอนนี้พวกเขามีวัตถุประสงค์ที่แตกต่างกันและ ทั้งสองต้องใช้ค่าที่มาจาก GET /api/esim/countries endpoint — สตริงที่กำหนดเองไม่สามารถใช้ได้อีกต่อไป.
| Parameter | Accepted value | Source |
|---|---|---|
| country | Full country name | name field from the Country API |
| countryCode | ISO country code | code field from the Country API |
Action required: หากคุณกำลังส่งสตริงประเทศแบบข้อความอิสระอยู่ในขณะนี้ ให้ปรับปรุงการเชื่อมต่อของคุณเพื่อเรียก GET /api/esim/countries ก่อนและใช้ name หรือ code ค่าจากการตอบกลับ.
จุดสิ้นสุดใหม่ #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
ส่งคืนรายการของประเทศทั้งหมดที่รองรับโดย Roamify eSIM ใช้ name และ code ค่าจากการตอบสนองนี้เป็นค่าตัวกรองเมื่อเรียก GET /api/esim/packages.
พารามิเตอร์ตัวกรองที่เลือกได้พร้อมกับ geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
ส่งข้อความ SMS โดยตรงไปยัง eSIM.
| ชื่อ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
| iccid | สตริง | จำเป็น | ICCID ของ eSIM ที่จะส่ง SMS ไปยัง. |
| ข้อความ | สตริง | จำเป็น | เนื้อหาข้อความที่จะส่ง. |
อัปเดตจุดสิ้นสุด #
POST /api/esim/apply — startDate รองรับแล้ว #
ฟิลด์ startDate ใหม่ที่ไม่บังคับได้ถูกเพิ่มเข้ามาในจุดสิ้นสุดการสร้างโปรไฟล์ eSIM สำหรับแพ็คเกจขนาดเล็กบางส่วน (~30 จาก 28,000+) ฟิลด์นี้เป็น จำเป็น.
คุณสามารถระบุแพ็คเกจเหล่านี้ได้โดยการตรวจสอบว่า requirements.travelDate เป็น true ในวัตถุแพ็คเกจ หากจำเป็นและไม่ได้ระบุ คำขอการสร้างโปรไฟล์จะล้มเหลว.
| ชื่อ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
| startDate | string | ตามเงื่อนไข | วันที่เริ่มต้นการเดินทางในรูปแบบ ISO 8601 จำเป็นหาก requirements.travelDate เป็นจริง. |
การเตือนเวลาหมด
เอกสาร API เต็มรูปแบบ #
เอกสารฉบับเต็มสามารถดูได้ที่ docs.getroamify.com.
หากคุณมีคำถามหรือจำเป็นต้องขอความช่วยเหลือในการอัปเดตการรวมของคุณ โปรดติดต่อทีมสนับสนุนพันธมิตรของเรา.
แผนปลายทาง eSIM ที่เกี่ยวข้อง
คำถามที่พบบ่อย
- ฉันจะเรียนรู้อะไรบ้างใน Roamify eSIM API การเปลี่ยนแปลงที่สำคัญ
- คุณจะได้เรียนรู้วิธีการเปิดใช้งาน eSIM วิธีเปรียบเทียบแผนข้อมูล และขั้นตอนการตั้งค่าที่สำคัญที่สุดก่อนและระหว่างการเดินทางของคุณ
- ฉันจะเลือกแผน eSIM ที่เหมาะสมสำหรับ ญี่ปุ่น ได้อย่างไร
- จับคู่แผนของคุณกับระยะเวลาการเดินทาง การใช้อินเทอร์เน็ตรายวันที่คาดหวัง ความต้องการฮอตสปอต และคุณภาพเครือข่ายในจุดหมายปลายทางของคุณ การเข้าพักระยะสั้นมักต้องการข้อมูลน้อยลง ในขณะที่การทำงานระยะไกลและการโทรวิดีโอต้องการมากขึ้น
- ฉันจะซื้อแผน eSIM สำหรับการเดินทางสำหรับ ญี่ปุ่น และ ไทย ได้ที่ไหน
- ใช้ลิงก์ปลายทางในคู่มือนี้เพื่อไปที่หน้า Roamify ประเทศโดยตรง เปรียบเทียบตัวเลือกแผน และชำระเงินให้เสร็จสิ้นก่อนออกเดินทาง