অ্যাকাউন্টের ব্যালেন্স দেখুন

আপনার API পরিচয়প্রমাণ যে অ্যাকাউন্টের, সেই অ্যাকাউন্টের ব্যালেন্স, মুদ্রা ও অর্থপ্রদানের শর্তাবলির মান দেখুন। এটি ব্যালেন্স দেখার একটি প্রক্রিয়া; এটি অর্থ যোগ করে না বা অর্ডার দেয় না।

অনুরোধ

HTTPS-এর মাধ্যমে সার্ভার-পক্ষের API পরিচয়প্রমাণ ব্যবহার করুন। উদাহরণগুলো এনভায়রনমেন্ট ভেরিয়েবল থেকে পরিচয়প্রমাণ পড়ে; এগুলোতে ব্যবহারযোগ্য কোনো পরিচয়প্রমাণ নেই। JSON বডিতে থাকা status.code এবং 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"
  }
}

ত্রুটি ও ব্যবহার

পরিচয় যাচাই ব্যর্থ হলে API-এর সাধারণ পরিচয় যাচাইয়ের প্রতিক্রিয়া ব্যবহার করা হয়। এই হ্যান্ডলার ব্যালেন্স অনুপস্থিত থাকার জন্য আলাদা কোনো ত্রুটি বা পৃষ্ঠাভাগের ব্যবস্থা নির্ধারণ করে না। ফেরত পাওয়া ব্যালেন্সের অর্থ এই নয় যে অর্থ সংরক্ষিত রাখা হয়েছে, এবং এটি পরবর্তী কোনো অর্ডার সফল হওয়ার নিশ্চয়তা দেয় না।