Izstrādātājiem

GET/v3/getbalance

Iegūt konta atlikumu

Iegūstiet sava API konta saglabāto atlikumu, valūtu un maksājumu nosacījumus.

Šajā lapā
  1. Pieprasījums
  2. Atbilde
  3. Kļūdas un lietošana

Iegūstiet tā konta atlikumu, valūtu un maksājumu nosacījumu vērtību, kuram atbilst jūsu API piekļuves dati. Tā ir atlikuma pārbaude; tā nepapildina kontu un neveic pasūtījumu.

Pieprasījums

Izmantojiet servera pusē glabātus API piekļuves datus, sazinoties ar HTTPS starpniecību. Piemēros piekļuves dati tiek nolasīti no vides mainīgajiem; tajos nav derīgu piekļuves datu. Pārbaudiet status.code JSON atbildes saturā, kā arī HTTP statusu. Šie mantotie apstrādātāji lietojumprogrammas kļūdas gadījumā ne vienmēr iestata HTTP kļūdas statusu.

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

Nav nepieciešami ceļa, vaicājuma vai pieprasījuma satura parametri.

Atbilde

Šis ir atbildes struktūras piemērs, nevis konta dati vai aktuāls cenas piedāvājums.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "balance": "125.50",
    "currency": "USD",
    "terms": "prepaid"
  }
}
Atlikuma atbildes lauki
LauksNozīme
balanceSaglabātais konta atlikums. Apstrādājot naudas summas, saglabājiet decimālo precizitāti.
currencyŠim kontam saglabātā valūtas vērtība.
termsKontam saglabātā maksājumu nosacījumu vērtība. Apstrādātājs neuzskaita tās iespējamās vērtības un to nenormalizē; nepieņemiet, ka piemērā ir norādītas visas iespējamās vērtības.

Kļūdas un lietošana

Autentifikācijas kļūmes gadījumā tiek izmantota kopīgā API autentifikācijas atbilde. Šis apstrādātājs nenosaka atsevišķu kļūdu gadījumam, kad nav atlikuma, un neparedz dalīšanu lapās. Atbildē atgrieztais atlikums nenozīmē līdzekļu rezervēšanu un negarantē, ka vēlāks pasūtījums izdosies.