Az API-hitelesítő adatokhoz tartozó számla egyenlegének, pénznemének és fizetési feltételekre vonatkozó értékének lekérdezése. Ez egy egyenleglekérdezés; nem tölt fel pénzt, és nem ad le rendelést.
Kérés
Használjon szerveroldali API-hitelesítő adatokat HTTPS-kapcsolaton keresztül. A példák környezeti változókból olvassák be a hitelesítő adatokat; nem tartalmaznak működő hitelesítő adatokat. Ellenőrizze a status.code értékét a JSON-törzsben, valamint a HTTP-állapotot is. Ezek a régi kezelők alkalmazáshiba esetén nem állítanak be következetesen hibát jelző HTTP-állapotot.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/getbalance"Nincs szükség útvonal-, lekérdezési vagy törzsparaméterekre.
Válasz
Ez a válasz szerkezetét szemléltető példa, nem tényleges számlaadat vagy aktuális árajánlat.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "125.50",
"currency": "USD",
"terms": "prepaid"
}
}| Mező | Jelentés |
|---|---|
balance | A tárolt számlaegyenleg. Pénzösszegek feldolgozásakor őrizze meg a tizedes pontosságot. |
currency | Az ehhez a számlához tárolt pénznemérték. |
terms | A számla fizetési feltételekre vonatkozó tárolt értéke. A kezelő nem sorolja fel a lehetséges értékeket, és nem normalizálja ezt az értéket; ne feltételezze, hogy a példa az összes lehetséges értéket bemutatja. |
Hibák és használat
Sikertelen hitelesítés esetén az API közös hitelesítési válasza kerül visszaadásra. Ez a kezelő nem határoz meg külön hibát a hiányzó egyenlegre, és nem biztosít lapozást. A visszaadott egyenleg nem jelent pénzösszeg-foglalást, és nem garantálja egy későbbi rendelés sikerét.