ค้นหาหมายเลขมือถือที่ว่าง

ยืนยันว่าเปิดใช้คลังหมายเลขมือถือแล้ว

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

เส้นทางแบบเดิมในปัจจุบันไม่ได้ปฏิเสธคำขอที่ไม่มีสิทธิ์ทุกรายการอย่างเชื่อถือได้ บัญชีที่ยังไม่ได้เปิดใช้คลังหมายเลขมือถืออาจได้รับคลังหมายเลขธรรมดาในขณะที่การตอบกลับยังคงระบุว่า info.is_mobile: 1 คำนำหน้าโทรฟรีก็อาจเข้าถึงสาขาคลังหมายเลขโทรฟรีพร้อมป้ายกำกับนั้นได้เช่นกัน อย่าใช้ป้ายกำกับนี้เพียงอย่างเดียวเพื่อระบุบริการมือถือ และอย่าส่งคำนำหน้าธรรมดาหรือคำนำหน้าโทรฟรีไปยังจุดปลายทางนี้ ให้ใช้แค็ตตาล็อกมือถือที่ได้รับการยืนยันและขั้นตอนการทำงานที่เปิดใช้แล้วของบัญชี

เก็บแต่ละหมายเลขไว้คู่กับตัวเลือกราคาของหมายเลขนั้นเอง

สำหรับตัวเลือกหมายเลขแต่ละรายการ ให้เก็บ number, info.uuid และรายการ price ของรายการเดียวกันนั้นไว้ด้วยกัน การตอบกลับยังมีเมตาดาต้าคำนำหน้า/พื้นที่/ประเทศ เงื่อนไขสัญญา และข้อจำกัดการลงทะเบียนด้วย ตัวเลือกหมายเลขจะเรียงตามราคารายเดือนของตัวเลือกราคาแรกจากน้อยไปมาก และไม่มีการรับประกันลำดับที่คงที่สำหรับราคาที่เท่ากัน อย่าแทนที่ ID หมายเลขที่ส่งกลับมาด้วย ID พื้นที่หรือ ID คำนำหน้า และอย่าจับคู่กับ ID ราคาของตัวเลือกหมายเลขอื่น

การตอบกลับฉบับสมบูรณ์อาจมีฟิลด์เมตาดาต้าและราคาเพิ่มเติม ค่า features ค่าช่องสัญญาณ และ restrictions ที่ส่งกลับมาอธิบายตัวเลือกหมายเลขนั้น แต่ไม่ใช่การรับประกันว่าการโทร SMS MMS หรือแฟกซ์จะใช้งานได้แล้ว สิทธิ์ของบัญชี การลงทะเบียน และแผนบริการที่เลือกยังคงมีผลบังคับใช้ อย่าถือว่าตัวแทนค่าในตัวอย่างเป็น ID หรือราคาที่ถูกต้อง

ใช้จำนวนบวกขนาดเล็ก

เริ่มต้นด้วยจำนวน 1 คำขอตามปกติไปยังผู้ให้บริการจะปรับจำนวนที่ไม่เป็นบวกให้เป็น 1 และจำกัดค่าที่ส่งไปต้นทางไว้ที่ 300 แต่การจัดการผลลัพธ์ในภายหลังยังคงใช้ค่าที่ป้อนเดิม ดังนั้นจำนวนศูนย์จึงอาจขอคลังหมายเลขจากต้นทางแล้วไม่ส่งตัวเลือกหมายเลขกลับมาเลย สาขาแบบเดิมอื่นๆ ไม่ได้บังคับใช้จำนวนผลลัพธ์ที่ขอไว้อย่างสม่ำเสมอ อย่าพึ่งพาค่าสูงสุดสากลเพียงค่าเดียว และอย่าส่งค่าติดลบ ค่าเศษส่วน หรือค่าที่ไม่ใช่ตัวเลข ไม่มีตัวกรองการค้นหาสาธารณะที่รองรับหรือพารามิเตอร์เนื้อหา ID ราคาที่มีการบันทึกไว้สำหรับเส้นทางนี้

แยกแยะระหว่างไม่มีสต็อกกับการค้นหาล้มเหลว

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

ตรวจสอบอีกครั้งก่อนซื้อ

การค้นหาไม่ได้จองสต็อก สาขาที่ได้รับการตรวจสอบพยายามคัดหมายเลขที่ถูกซื้อไปแล้วออก แต่การค้นหาระเบียนการจองภายในระบบที่ล้มเหลวอาจทำให้ตัวเลือกหมายเลขดังกล่าวยังคงอยู่ในผลลัพธ์ ความพร้อมใช้งาน ความเป็นเจ้าของ ราคาที่ได้รับอนุมัติ และการลงทะเบียนต้องได้รับการตรวจสอบโดยขั้นตอนการซื้อ ให้ใช้การเลือกใหม่ร่วมกับคำขอซื้อแบบมีการป้องกัน และกระทบยอดคลังหมายเลขของบัญชีหลังผลการซื้อที่ไม่แน่นอนใดๆ ก่อนลองใหม่ อย่าซื้อเพียงเพราะมีการส่งตัวเลือกหมายเลขกลับมา

คำขอ

ใช้บัญชี API ที่เปิดใช้แล้วผ่าน HTTPS จากที่อยู่ IP ต้นทางที่ได้รับอนุญาต คลังหมายเลขมือถือต้องเปิดใช้สำหรับบัญชีลูกค้าด้วย การยืนยันตัวตน API เพียงอย่างเดียวไม่ได้เปิดใช้คลังหมายเลขนี้

GET พร้อมตัวระบุคำนำหน้ารายตัวปัจจุบันและจำนวนเต็มบวกในเส้นทาง URL หากละไว้ จำนวนจะมีค่าเริ่มต้นเป็น 1 ให้ใช้ตัวอย่างที่มีค่า 1 เส้นทางนี้ไม่ได้ตรวจสอบความถูกต้องหรือบังคับใช้ขีดจำกัดผลลัพธ์สากลอย่างสม่ำเสมอ

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

การตอบกลับ

ตรวจสอบ status.code และ status.msg ในเนื้อหา JSON รวมถึงสถานะ HTTP เมื่อสำเร็จ response จะเป็นรายการตัวเลือกหมายเลข status.msg จะเป็น Results: ตามด้วยจำนวนที่ส่งกลับมา และ status.results จะเป็นความยาวของรายการที่ถูกซีเรียลไลซ์ ราคาของตัวเลือกหมายเลขขึ้นอยู่กับแต่ละบัญชี ตัวอย่างประกอบแบบย่อใช้ตัวแทนค่าแทนคลังหมายเลขจริงหรือใบเสนอราคาค่าบริการ หมายเลขมีรหัสประเทศโดยไม่มีเครื่องหมายบวก ตัวระบุเป็นสตริงที่ให้ใช้เป็นค่าระบุโดยไม่ตีความโครงสร้างภายใน

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

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

ข้อผิดพลาด

• 404: ID คำนำหน้า ประเทศ หรือพื้นที่ไม่ถูกต้อง: ให้รีเฟรชการเลือกคำนำหน้ามือถือรายตัว
• 404: ไม่พบหมายเลข: อาจหมายถึงไม่มีสต็อกที่ใช้ได้ บริการถูกปิดใช้ การค้นหาจากผู้ให้บริการล้มเหลว การเลือกที่ไม่รองรับ หรือข้อจำกัดของบัญชี ไม่ใช่หลักฐานว่าจำนวนคลังหมายเลขเป็นศูนย์อย่างเป็นทางการ

ความพร้อมใช้งานและผลข้างเคียง

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