Hämta saldot, valutan och värdet för betalningsvillkor för det konto som dina API-inloggningsuppgifter avser. Detta är en saldoförfrågan; den tillför inga pengar och lägger ingen beställning.
Begäran
Använd API-inloggningsuppgifter på serversidan via HTTPS. Exemplen läser inloggningsuppgifter från miljövariabler; de innehåller inga fungerande inloggningsuppgifter. Kontrollera status.code i JSON-svarskroppen samt HTTP-statusen. Dessa äldre hanterare anger inte konsekvent en HTTP-felstatus vid ett applikationsfel.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/getbalance"Inga parametrar för sökväg, frågesträng eller begärandekropp krävs.
Svar
Detta är ett exempel på svarets struktur, inte kontouppgifter eller en aktuell prisuppgift.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "125.50",
"currency": "USD",
"terms": "prepaid"
}
}| Fält | Betydelse |
|---|---|
balance | Det lagrade kontosaldot. Bevara decimalprecisionen när du behandlar penningbelopp. |
currency | Det valutavärde som är lagrat för detta konto. |
terms | Kontots lagrade värde för betalningsvillkor. Hanteraren räknar inte upp de möjliga värdena och normaliserar inte värdet; utgå inte från att exemplet täcker alla möjliga värden. |
Fel och användning
Vid misslyckad autentisering används API:ets gemensamma autentiseringssvar. Denna hanterare definierar varken ett separat fel för saknat saldo eller paginering. Ett returnerat saldo innebär ingen reservation av pengar och garanterar inte att en senare beställning lyckas.