დეველოპერებისთვის

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