อ่านแผนราคาหมายเลขที่บันทึกไว้

อ่านแผนราคาที่บันทึกไว้

ค้นหาแถวราคาที่บันทึกไว้สำหรับบัญชี API ของคุณหลังจากเรียกดูหมายเลขโทรศัพท์ที่ว่างอยู่ ใช้ค่า uuid ของตัวเลือกราคาจากรายการ price ของหมายเลขที่เลือก ไม่ใช่หมายเลข รหัสคำนำหน้า (prefix ID) หรือรหัสพื้นที่ (area ID) ของหมายเลขนั้น เก็บหมายเลขที่เลือกและตัวเลือกราคาไว้ด้วยกัน

นี่เป็นการค้นหาแบบเข้ากันได้ (compatibility) ของราคาที่บันทึกไว้ ไม่ได้รีเฟรชความพร้อมใช้งานหรือราคา ไม่ได้จองหมายเลข ไม่ได้สั่งซื้อ และไม่รับประกันจำนวนเงินของการซื้อในอนาคต โปรดตรวจสอบตัวเลือกราคาที่ได้จากการค้นหาหมายเลขครั้งใหม่ก่อนสั่งซื้อ

คำขอ

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"

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

การตอบกลับ

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

response เป็นลิสต์เสมอ แม้จะมีเพียงแถวเดียว status.results นับจำนวนแถวที่ส่งคืน ค่าตัวเลขจากฐานข้อมูลอาจเป็นสตริง เอนด์พอยต์นี้ไม่เพิ่มฟิลด์สกุลเงินและไม่แปลงสกุลเงิน โปรดยืนยันสกุลเงินสำหรับการเรียกเก็บเงินของบัญชี แทนที่จะอนุมานจากตัวอย่างนี้

ฟิลด์ราคา

จัดการกับแถวที่ตรงกันหลายแถว

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

เวิร์กโฟลว์ตรวจสอบคำสั่งซื้อของพอร์ทัลจะทำการตรวจสอบการเลือกและความถูกต้องเพิ่มเติม อย่าสันนิษฐานว่าการค้นหารุ่นเก่านี้มีการตรวจสอบเหล่านั้น หรือยอมรับตัวระบุทุกตัวที่พอร์ทัลยอมรับ

การตอบกลับที่ว่างเปล่าและข้อผิดพลาด

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

การยืนยันตัวตน ข้อจำกัดด้าน IP ต้นทาง และความล้มเหลวของฐานข้อมูลก็อาจทำให้ไม่ได้รับการตอบกลับที่ใช้งานได้เช่นกัน ไม่มีซองข้อผิดพลาดเฉพาะของตัวจัดการสำหรับข้อยกเว้นของฐานข้อมูล ให้รีเฟรชการเลือกของคุณหรือติดต่อฝ่ายสนับสนุนเมื่อการค้นหาที่ยืนยันตัวตนแล้วยังคงใช้งานไม่ได้

ผลกระทบและข้อจำกัด

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