นักพัฒนา

GET/v3/getbalance

ดูยอดเงินคงเหลือในบัญชี

ดูยอดเงินคงเหลือ สกุลเงิน และเงื่อนไขการชำระเงินที่จัดเก็บไว้สำหรับบัญชี API ของคุณ

ในหน้านี้
  1. คำขอ
  2. การตอบกลับ
  3. ข้อผิดพลาดและการใช้งาน

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

คำขอ

ใช้ข้อมูลรับรอง API ฝั่งเซิร์ฟเวอร์ผ่าน HTTPS ตัวอย่างจะอ่านข้อมูลรับรองจากตัวแปรสภาพแวดล้อม และไม่มีข้อมูลรับรองที่ใช้งานได้จริง ให้ตรวจสอบ status.code ในเนื้อหา JSON ควบคู่กับสถานะ HTTP ตัวจัดการรุ่นเก่าเหล่านี้ไม่ได้กำหนดสถานะข้อผิดพลาด HTTP อย่างสม่ำเสมอเมื่อเกิดข้อผิดพลาดในระดับแอปพลิเคชัน

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/getbalance"

ไม่จำเป็นต้องระบุพารามิเตอร์ในเส้นทาง สตริงการค้นหา หรือเนื้อหาคำขอ

การตอบกลับ

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "balance": "125.50",
    "currency": "USD",
    "terms": "prepaid"
  }
}
ฟิลด์ในการตอบกลับยอดเงินคงเหลือ
ฟิลด์ความหมาย
balanceยอดเงินคงเหลือในบัญชีที่จัดเก็บไว้ เมื่อใช้ค่าจำนวนเงิน ให้คงความแม่นยำของทศนิยมไว้
currencyค่าสกุลเงินที่จัดเก็บไว้สำหรับบัญชีนี้
termsค่าเงื่อนไขการชำระเงินของบัญชีที่จัดเก็บไว้ ตัวจัดการไม่ได้แจกแจงค่าที่เป็นไปได้หรือปรับค่านี้ให้เป็นรูปแบบมาตรฐาน อย่าถือว่าตัวอย่างครอบคลุมค่าที่เป็นไปได้ทั้งหมด

ข้อผิดพลาดและการใช้งาน

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