เอนด์พอยต์รุ่นเดิมนี้ส่งคืนเนื้อหาข้อความรูปแบบ {"code", "data"} แทนโครงสร้างครอบข้อมูล status/response แบบมาตรฐาน โดยแสดงรายชื่อประเทศที่แสดงอยู่และเชื่อมโยงกับแค็ตตาล็อกหมายเลขพิเศษ และไม่ตรวจสอบว่ามีหมายเลขเหลืออยู่หรือไม่
สำหรับการเชื่อมต่อระบบใหม่:
- ใช้
GET /v3/getcountriesเพื่อค้นหาประเทศที่มีหมายเลขเหลืออยู่ - ใช้
GET /v3/other/{isocode}เพื่อดูว่าประเทศนั้นมีหมายเลขพิเศษประเภทใดให้บริการจริงบ้าง ประเทศที่มีชื่ออยู่ในรายการนี้อาจยังส่งคืนแค็ตตาล็อกว่างเมื่อเรียกใช้เอนด์พอยต์ดังกล่าว
คำขอ
จำเป็นต้องใช้: การยืนยันตัวตนแบบ HTTP Basic หรือโทเค็น Bearer (ดูหัวข้อการยืนยันตัวตนและการตอบกลับของ API) หากยืนยันตัวตนไม่สำเร็จ ระบบจะตอบกลับด้วย HTTP 401 ในโครงสร้างครอบข้อมูลแบบมาตรฐานก่อนดำเนินการค้นหา
GET โดยไม่มีพารามิเตอร์และไม่มีเนื้อหาคำขอ
curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'การตอบกลับ
เนื้อหาข้อความรูปแบบเดิมที่ไม่มีโครงสร้างครอบข้อมูลแบบมาตรฐาน: {code: 200, data: [...]}. ไม่มีออบเจ็กต์ status หรือฟิลด์ msg หรือ results ส่วน data แสดงรายชื่อประเทศโดยไม่รับประกันลำดับ ฟิลด์ต่าง ๆ ได้แก่ countrycode (รหัสโทรศัพท์ประเทศที่ไม่มี '+'), name, description (มีค่าเดียวกับ name), isocode, latitude และ longitude ไม่มีฟิลด์ is_mobile, sms_coverage หรือ next_function ประเทศจะปรากฏในรายการเมื่อแสดงอยู่และเชื่อมโยงกับแค็ตตาล็อกหมายเลขพิเศษ ระบบไม่ตรวจสอบว่ามีหมายเลขเหลืออยู่หรือไม่ ดังนั้นประเทศที่อยู่ในรายการอาจไม่มีหมายเลขพร้อมให้บริการในขณะนั้น หากไม่มีประเทศใดตรงตามเงื่อนไข data จะเป็น null
ตัวอย่างโครงสร้างการตอบกลับ ไม่ใช่ข้อมูลบัญชีจริงหรือใบเสนอราคาปัจจุบัน
{
"code": 200,
"data": [
{
"countrycode": "33",
"name": "France",
"description": "France",
"isocode": "FR",
"latitude": "46.0000",
"longitude": "2.0000"
}
]
}ข้อผิดพลาด
- 401: ไม่มีข้อมูลยืนยันตัวตนหรือยืนยันตัวตนไม่สำเร็จ ส่งกลับด้วย HTTP status 401 ในโครงสร้างครอบข้อมูล status/response แบบมาตรฐาน ไม่ใช่ในเนื้อหาข้อความรูปแบบเดิม
ความพร้อมให้บริการและผลกระทบข้างเคียง
- ใช้สำหรับค้นหาข้อมูลเท่านั้น ไม่มีการจอง สั่งซื้อ หรือเปลี่ยนแปลงสิ่งใด