მიიღეთ იმ ანგარიშის ბალანსი, ვალუტა და გადახდის პირობების მნიშვნელობა, რომელსაც თქვენი 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-ის ავთენტიფიკაციის საერთო პასუხი. ეს დამმუშავებელი არ განსაზღვრავს ცალკე შეცდომას ბალანსის არარსებობისთვის ან გვერდებად დაყოფას. დაბრუნებული ბალანსი თანხის რეზერვაციას არ ნიშნავს და არ იძლევა გარანტიას, რომ შემდგომი შეკვეთა წარმატებით შესრულდება.