นักพัฒนา

GET/v3/countries

แสดงรายชื่อประเทศในแค็ตตาล็อก (รูปแบบเดิม)

เอนด์พอยต์รุ่นเดิมที่ส่งคืนประเทศที่แสดงอยู่และเชื่อมโยงกับแค็ตตาล็อกหมายเลขพิเศษที่ GET /v3/other/{isocode} ใช้งาน โดยใช้เนื้อหาข้อความรูปแบบ {code, data} เอนด์พอยต์นี้ไม่ตรวจสอบว่ามีหมายเลขเหลืออยู่หรือไม่ ใช้ GET /v3/getcountries เพื่อค้นหาประเทศที่มีหมายเลขเหลืออยู่

ในหน้านี้
  1. คำขอ
  2. การตอบกลับ
  3. ข้อผิดพลาด
  4. ความพร้อมให้บริการและผลกระทบข้างเคียง

เอนด์พอยต์รุ่นเดิมนี้ส่งคืนเนื้อหาข้อความรูปแบบ {"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 แบบมาตรฐาน ไม่ใช่ในเนื้อหาข้อความรูปแบบเดิม

ความพร้อมให้บริการและผลกระทบข้างเคียง

  • ใช้สำหรับค้นหาข้อมูลเท่านั้น ไม่มีการจอง สั่งซื้อ หรือเปลี่ยนแปลงสิ่งใด