นักพัฒนา

GET/v3/get_document_number_types/{country}

แสดงรายการประเภทหมายเลขสำหรับการลงทะเบียน

ค้นหาชื่อประเภทหมายเลขที่มีอยู่ในแค็ตตาล็อกการลงทะเบียนของประเทศหนึ่งในขณะนี้

ในหน้านี้
  1. เลือกประเภทโดยใช้ชื่อที่ส่งกลับมา
  2. จำนวนกลุ่มไม่ใช่จำนวนหมายเลขที่มีให้บริการ
  3. คำขอ
  4. การตอบกลับ
  5. ข้อผิดพลาด
  6. ความพร้อมให้บริการและผลข้างเคียง

เลือกประเภทโดยใช้ชื่อที่ส่งกลับมา

ใช้ประเทศจาก get_document_countries ส่งชื่อประเภทที่ได้รับกลับมาให้ get_requirements รหัสประเภทในแค็ตตาล็อกไม่ใช่รหัสคำนำหน้าหมายเลข รหัสหมายเลข หรือรหัสหมวดหมู่หลักฐาน

จำนวนกลุ่มไม่ใช่จำนวนหมายเลขที่มีให้บริการ

available_groups นับจำนวนระเบียนกลุ่มที่ส่งกลับมาจากการค้นหาแค็ตตาล็อกนี้ ไม่ได้นับจำนวนหมายเลขโทรศัพท์ที่ซื้อได้ ไม่ได้สำรองหมายเลขไว้ และไม่ได้รับประกันว่าแค็ตตาล็อกได้ดึงข้อมูลจากหน้าทั้งหมดของแหล่งข้อมูลต้นทางแล้ว ให้ค้นหาหมายเลขที่มีให้บริการในรายการที่เกี่ยวข้องและตรวจสอบใบเสนอราคาแยกต่างหาก

คำขอ

ใช้ข้อมูลรับรองของบัญชี API ที่เปิดใช้งานแล้วของคุณผ่าน HTTPS รองรับการยืนยันตัวตนแบบ Basic และโทเค็น bearer ของบัญชี API ที่เปิดใช้งานแล้ว โดยยังอยู่ภายใต้ข้อจำกัดของบัญชี

ใช้ GET โดยระบุพารามิเตอร์ใด ๆ ที่ระบุไว้ในเอกสารในพาธของ URL

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"
พารามิเตอร์ในพาธ
ชื่อชนิดข้อมูลจำเป็นคำอธิบาย
countrystringใช่รหัสประเทศ ISO แบบตัวอักษรสองตัวจากแค็ตตาล็อกประเทศสำหรับการลงทะเบียน โดยจะตัดช่องว่างที่ต้นและท้ายออกและแปลงเป็นตัวพิมพ์ใหญ่

การตอบกลับ

ตรวจสอบ status.code ในเนื้อหา JSON ควบคู่กับสถานะ HTTP โดย response เป็นอาร์เรย์ที่มี id, name และ available_groups ใช้ name เป็นค่า number_type เมื่อเรียก get_requirements อย่าส่ง id แทน ส่วน available_groups คือจำนวนระเบียนกลุ่มที่ส่งกลับมาสำหรับประเภทนั้น ไม่ใช่จำนวนหมายเลขโทรศัพท์ที่มีอยู่หรือยอดรวมครบทุกหน้าของข้อมูลที่แบ่งหน้า ประเภทที่ไม่มีกลุ่มส่งกลับมาจะไม่ถูกรวมไว้ ลำดับที่แนะนำคือ Local, Mobile, National, Toll Free, Shared Cost, Global ตามด้วยชื่ออื่น ๆ ในแค็ตตาล็อก

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

ข้อผิดพลาด

  • 400: country is required: ระบุรหัส ISO ของประเทศสำหรับการลงทะเบียน
  • 400: Invalid country ISO or no available DID registration country found: เลือกประเทศจากแค็ตตาล็อกการลงทะเบียนปัจจุบัน ข้อความนี้ไม่ได้ยืนยันว่าไม่จำเป็นต้องใช้เอกสาร

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

  • การค้นหาแค็ตตาล็อกหรือข้อกำหนดนี้ไม่ได้สร้างข้อมูลตัวตน อัปโหลดหลักฐาน ลงทะเบียนหมายเลข หรือส่งคำสั่งซื้อ
  • การตอบกลับจากแค็ตตาล็อกที่สำเร็จไม่ได้หมายถึงการอนุมัติเอกสารของคุณหรือการยืนยันว่าสามารถเปิดใช้งานหมายเลขที่เลือกได้