Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
api:balance [2014/01/13 12:52] – michal | api:balance [2015/05/15 16:30] – misa |
---|
* vyžaduje [[:api#autentizace|autentizaci]] | * vyžaduje [[:api#autentizace|autentizaci]] |
* příklad odpovědi: <code>193.32</code> | * příklad odpovědi: <code>193.32</code> |
| |
| === GET /balance.xml === |
| |
| * vrací aktuální kredit uživatele v Kč zaokrouhlený na dvě desetinná místa |
| * formát odpovědi: XML |
| * vyžaduje [[:api#autentizace|autentizaci]] |
| * nepovinné parametry: |
| * **format**: nastavením na hodnotu //acrobits// bude vráceno XML pro klienta Acrobits Softphone |
| |
=== POST /balance_transfer.json === | === POST /balance_transfer.json === |
* vyžaduje [[:api#autentizace|autentizaci]] | * vyžaduje [[:api#autentizace|autentizaci]] |
* povinné parametry: | * povinné parametry: |
* **recipient**: účet na který se kredit převádí; PIN bez posledních 4 číslic (bývá to tedy buď mobilní číslo, na které je účet registrován, anebo číslo linky daného uživatele) | * **recipient**: účet, na který se kredit převádí; PIN bez posledních 4 číslic (bývá to tedy buď mobilní číslo, na které je účet registrován, anebo číslo linky daného uživatele) |
* **amount**: částka určená k převedení; minimálně 50 Kč, na účtu odesílatele musí zůstat alespoň 10 Kč | * **amount**: částka určená k převedení; minimálně 50 Kč, na účtu odesílatele musí zůstat alespoň 10 Kč |
* možné chybové stavy: | * možné chybové stavy: |
* //low_amount//: musí být převáděno minimálně 10 Kč | * //low_amount//: musí být převáděno minimálně 10 Kč |
* //low_balance//: uživatelský účet odesílatele musí mít minimálně kredit 50 Kč | * //low_balance//: uživatelský účet odesílatele musí mít minimálně kredit 50 Kč |
* //not_paid_yet//: posílat kredit je možné až po první dobití | * //not_paid_yet//: posílat kredit je možné až po prvním dobití |
* //invalid_amount//: neplatná částka, například vyšší než současný stav kreditu | * //invalid_amount//: neplatná částka, například vyšší než současný stav kreditu |
* //low_leftover//: na účtu odesílatele musí zůstat alespoň 10 Kč | * //low_leftover//: na účtu odesílatele musí zůstat alespoň 10 Kč |