Arendajad

GET/v3/getbalance

Konto saldo pärimine

Pärige oma API konto salvestatud saldo, valuuta ja maksetingimused.

Sellel lehel
  1. Päring
  2. Vastus
  3. Vead ja kasutamine

Pärige oma API autentimisandmetega seotud konto saldo, valuuta ja maksetingimuste väärtus. See on saldopäring; see ei lisa kontole raha ega esita tellimust.

Päring

Kasutage serveripoolseid API autentimisandmeid HTTPS-i kaudu. Näited loevad autentimisandmeid keskkonnamuutujatest; need ei sisalda toimivaid autentimisandmeid. Kontrollige status.code väärtust JSON-i sisus ning ka HTTP olekut. Need pärandkoodi päringutöötlejad ei määra rakenduse vea korral alati HTTP veaolekut.

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

Tee-, päringustringi- ega sisuparameetreid ei nõuta.

Vastus

See on vastuse struktuuri näide, mitte kontoandmed ega kehtiv hinnapakkumine.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "balance": "125.50",
    "currency": "USD",
    "terms": "prepaid"
  }
}
Saldopäringu vastuse väljad
VäliTähendus
balanceKonto salvestatud saldo. Rahaliste väärtuste töötlemisel säilitage kümnendtäpsus.
currencySelle konto jaoks salvestatud valuuta väärtus.
termsKonto salvestatud maksetingimuste väärtus. Päringutöötleja ei loetle selle võimalikke väärtusi ega normaliseeri seda; ärge eeldage, et näide hõlmab kõiki võimalikke väärtusi.

Vead ja kasutamine

Autentimise ebaõnnestumisel kasutatakse API ühist autentimisvastust. See päringutöötleja ei määra eraldi viga puuduva saldo korral ega lehekülgedeks jaotamist. Tagastatud saldo ei tähenda raha broneerimist ega taga hilisema tellimuse õnnestumist.