Hent saldoen, valutaen og værdien for betalingsbetingelser for den konto, som dine API-legitimationsoplysninger repræsenterer. Dette er et saldoopslag; det indsætter ikke penge og afgiver ikke en ordre.
Anmodning
Brug API-legitimationsoplysninger på serversiden via HTTPS. Eksemplerne læser legitimationsoplysninger fra miljøvariabler; de indeholder ingen fungerende legitimationsoplysninger. Kontrollér status.code i JSON-indholdet samt HTTP-statussen. Disse ældre handlere angiver ikke konsekvent en HTTP-fejlstatus ved en applikationsfejl.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/getbalance"Der kræves ingen sti-, forespørgsels- eller indholdsparametre.
Svar
Dette er et eksempel på svarets struktur, ikke kontodata eller et aktuelt pristilbud.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "125.50",
"currency": "USD",
"terms": "prepaid"
}
}| Felt | Betydning |
|---|---|
balance | Den gemte kontosaldo. Bevar decimalpræcisionen ved behandling af pengebeløb. |
currency | Den valutaværdi, der er gemt for denne konto. |
terms | Kontoens gemte værdi for betalingsbetingelser. Handleren opregner eller normaliserer den ikke; antag ikke, at eksemplet dækker alle mulige værdier. |
Fejl og brug
Ved mislykket autentificering bruges API'ets fælles autentificeringssvar. Denne handler definerer hverken en særskilt fejl for manglende saldo eller sideinddeling. En returneret saldo er ikke en reservation af penge og garanterer ikke, at en senere ordre vil lykkes.