แสดงรายชื่อประเทศที่มีหมายเลขพร้อมให้บริการ

เริ่มค้นหาหมายเลขท้องถิ่นได้ที่นี่ รายการนี้มีเฉพาะประเทศที่ปัจจุบันมีหมายเลขพร้อมให้บริการ การเรียกดูนี้ไม่ได้จองสิ่งใด

• ส่งค่า isocode ไปยัง getareas, ไปยัง getstates (เฉพาะ US และ CA) หรือไปยัง other.
• next_function ชี้ไปยัง v3/getareas/{isocode} เสมอ สำหรับสหรัฐอเมริกาและแคนาดา คุณสามารถเรียก getstates ก่อนเพื่อจำกัดขอบเขตตามรัฐหรือจังหวัด
• is_mobile และ sms_coverage เป็นตัวบ่งชี้ระดับประเทศ ไม่ใช่การรับประกันสำหรับหมายเลขทุกหมายเลข สำหรับสหรัฐอเมริกา is_mobile มีค่าเป็น 0 เว้นแต่บัญชีของคุณจะได้รับการเปิดใช้งานหมายเลขมือถือของสหรัฐอเมริกา
• ประเทศที่มีบริการเฉพาะหมายเลขที่ต้องสั่งซื้อเท่านั้นจะไม่ปรากฏในรายการ คุณยังสามารถเรียก getareas หรือ other โดยตรงสำหรับประเทศที่ไม่ปรากฏในรายการได้
• หากต้องการลำดับเฉพาะ ให้เรียงลำดับรายการด้วยตนเอง

หากไม่มีประเทศใดตรงตามเงื่อนไข response มีค่าเป็น null และ status.code มีค่าเป็น 200.

คำขอ

จำเป็นต้องใช้: การยืนยันตัวตนแบบ HTTP Basic หรือโทเค็น Bearer (ดูหัวข้อการยืนยันตัวตนและการตอบกลับของ API) หากการยืนยันตัวตนล้มเหลว ระบบจะตอบกลับด้วย HTTP 401 ก่อนดำเนินการค้นหา

ใช้ GET โดยไม่มีเนื้อหาคำขอ พารามิเตอร์เดียวคือ pid ซึ่งไม่บังคับระบุและส่งผ่านสตริงคิวรี

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/getcountries'

การตอบกลับ

ใช้โครงสร้างห่อหุ้มข้อมูลมาตรฐาน เมื่อสำเร็จ status.code มีค่าเป็น 200, status.msg มีค่าเป็น 'Results: N', status.results มีค่าเป็น N และ response เป็นรายชื่อประเทศโดยไม่รับประกันลำดับ ฟิลด์ต่าง ๆ ได้แก่: countrycode (รหัสโทรศัพท์ประเทศโดยไม่มี '+'); name (ชื่อประเทศ); description (ค่าเดียวกับ name); isocode (รหัส ISO 3166-1 alpha-2); is_mobile (0 หรือ 1 เป็นตัวบ่งชี้ในแค็ตตาล็อกระดับประเทศ โดยสำหรับ US จะมีค่าเป็น 0 เสมอ เว้นแต่บัญชีของคุณจะได้รับการเปิดใช้งานหมายเลขมือถือของ US); sms_coverage (0 หรือ 1 เป็นตัวบ่งชี้ในแค็ตตาล็อกระดับประเทศ); latitude และ longitude (พิกัดของประเทศ); next_function ('v3/getareas/{isocode}') ประเทศจะปรากฏในรายการก็ต่อเมื่อเปิดให้แสดงและปัจจุบันมีหมายเลขพร้อมให้บริการในกลุ่มเลขนำหน้าอย่างน้อยหนึ่งกลุ่มจากแหล่งหมายเลขคงคลังแหล่งใดก็ได้ ประเทศที่ให้บริการเฉพาะหมายเลขที่ต้องสั่งซื้อทั้งหมด (ไม่มีหมายเลขคงคลัง) จะไม่ปรากฏในรายการ การตรวจสอบหมายเลขคงคลังนี้มีขอบเขตกว้างกว่าตัวกรองที่ getareas ใช้ ดังนั้นในบางครั้งการเรียกปลายทางนั้นสำหรับประเทศที่ปรากฏในรายการอาจส่งคืน 'No areas found' หากไม่มีประเทศใดตรงตามเงื่อนไข status.code มีค่าเป็น 200, status.msg มีค่าเป็น 'Results: 0', จะไม่มีฟิลด์ status.results และ response มีค่าเป็น null

เป็นตัวอย่างโครงสร้างการตอบกลับ ไม่ใช่ข้อมูลบัญชีแบบสดหรือใบเสนอราคาปัจจุบัน

{
  "status": {
    "code": 200,
    "msg": "Results: 2",
    "results": 2
  },
  "response": [
    {
      "countrycode": "1",
      "name": "United States",
      "description": "United States",
      "isocode": "US",
      "is_mobile": 0,
      "sms_coverage": 1,
      "latitude": "38.0000",
      "longitude": "-97.0000",
      "next_function": "v3/getareas/US"
    },
    {
      "countrycode": "44",
      "name": "United Kingdom",
      "description": "United Kingdom",
      "isocode": "GB",
      "is_mobile": 1,
      "sms_coverage": 0,
      "latitude": "54.0000",
      "longitude": "-2.0000",
      "next_function": "v3/getareas/GB"
    }
  ]
}

ข้อผิดพลาด

• 401: ไม่มีข้อมูลการยืนยันตัวตนหรือการยืนยันตัวตนล้มเหลว ส่งกลับพร้อมสถานะ HTTP 401 (ดูหัวข้อการยืนยันตัวตนและการตอบกลับของ API)

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

• เป็นการค้นหาข้อมูลเท่านั้น ไม่มีการจอง สั่งซื้อ หรือเปลี่ยนแปลงสิ่งใด
• ผลลัพธ์แสดงหมายเลขคงคลัง ณ เวลาที่ส่งคำขอ และอาจเปลี่ยนแปลงระหว่างการเรียกแต่ละครั้ง