API kimlik bilgilerinizin temsil ettiği hesabın bakiyesini, para birimini ve ödeme koşulları değerini sorgulayın. Bu işlem bir bakiye sorgusudur; hesaba para eklemez veya sipariş oluşturmaz.
İstek
Sunucu tarafındaki API kimlik bilgilerini HTTPS üzerinden kullanın. Örnekler kimlik bilgilerini ortam değişkenlerinden okur; geçerli kimlik bilgileri içermez. JSON gövdesindeki status.code değerini ve HTTP durumunu inceleyin. Bu eski işleyiciler, uygulama hataları için her zaman bir HTTP hata durumu ayarlamaz.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/getbalance"Yol, sorgu veya gövde parametreleri gerekmez.
Yanıt
Bu, yanıt yapısını gösteren bir örnektir; hesap verisi veya güncel bir fiyat teklifi değildir.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "125.50",
"currency": "USD",
"terms": "prepaid"
}
}| Alan | Anlamı |
|---|---|
balance | Kayıtlı hesap bakiyesi. Parasal değerleri işlerken ondalık hassasiyeti koruyun. |
currency | Bu hesap için kayıtlı para birimi değeri. |
terms | Hesabın kayıtlı ödeme koşulları değeri. İşleyici bu değerin alabileceği değerleri listelemez veya değeri standartlaştırmaz; örneğin olası tüm değerleri kapsadığını varsaymayın. |
Hatalar ve kullanım
Kimlik doğrulama başarısız olduğunda ortak API kimlik doğrulama yanıtı kullanılır. Bu işleyici, bakiyenin bulunmaması için ayrı bir hata veya sayfalama tanımlamaz. Döndürülen bakiye, fonların rezerve edildiği anlamına gelmez ve daha sonra verilecek bir siparişin başarılı olacağını garanti etmez.