Kayıtlı bir fiyat planını okuma
API hesabınız için kaydedilmiş fiyat satırlarını, kullanılabilir telefon numaralarına göz attıktan sonra sorgulayın. Fiyat seçeneğinin uuid değerini, seçilen numaranın price listesinden alarak kullanın; numaranın kendisini, önek kimliğini veya bölge kimliğini kullanmayın. Seçilen numarayı ve fiyat seçeneğini birlikte tutun.
Bu, kayıtlı fiyatlandırma için bir uyumluluk sorgusudur. Kullanılabilirliği veya fiyatları yenilemez, numara rezerve etmez, sipariş vermez ve gelecekteki bir satın almanın tutarını garanti etmez. Sipariş vermeden önce yeni bir numara aramasıyla döndürülen fiyat seçeneğini gözden geçirin.
İstek
Etkinleştirilmiş API hesabınızı, izin verilen bir IP adresinden HTTPS üzerinden kullanın. PRICE_ID değerini, aldığınız fiyat seçeneği kimliğiyle birebir aynı olacak şekilde ayarlayın. Yöntem tek bir yol bağımsız değişkeni okur; gövde, tarih veya sayfalama parametresi okumaz.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Bu sorguyu, fiyat seçeneğini alan hesabın kendisi yapmalıdır. Kendiniz bir kimlik oluşturmayın, veritabanı satır numarası kullanmayın veya başka bir hesabın seçimini yerine koymayın. Eski yöntem yalnızca görünür fiyat kimliğiyle eşleşme yapar.
Yanıt
Aşağıdaki kurgusal örnek yalnızca seçilmiş müşteriye yönelik alanları gösterir. Gerçek yanıtlar kayıtlı satırların tamamını döndürür ve ek hesap, tedarikçi ve dahili fiyatlandırma meta verileri içerebilir. Yanıtın tamamını sunucunuzda tutun ve yalnızca uygulamanızın ihtiyaç duyduğu müşteriye yönelik değerleri açığa çıkarın.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response alanı, tek bir satır için bile bir listedir. status.results döndürülen satırları sayar. Veritabanındaki sayısal değerler dize olabilir. Uç nokta para birimi alanı eklemez ve para birimi dönüştürmez; hesabın faturalandırma para birimini bu örnekten çıkarsamak yerine doğrulayın.
Fiyat alanları
| Alan | Anlamı |
|---|---|
| visible_uuid | Kayıtlı fiyat seçeneğinin görünür tanımlayıcısı. Sorguyu ilişkilendirirken özgün seçenek kimliğini kullanın. |
| setup_price | Bu seçenek için saklanan tek seferlik kurulum ücreti. |
| monthly_price | Saklanan yinelenen aylık ücret. |
| per_minute, free_minutes | Saklanan gelen arama dakika ücreti ve dahil edilen dakika miktarı. Bunlar giden aramaları veya olası her ek ücreti fiyatlandırmaz. |
| channels | Bu seçenek için saklanan kanal miktarı; canlı bir kapasite veya kayıt denetimi değildir. |
| yearly_price | Ek olarak saklanan bir yıllık ücret alanı bulunabilir. Sıfır olmayan bir aylık ücret ile sıfır değerli bir yıllık alanın ücretsiz bir yıllık planı temsil ettiği sonucunu çıkarmayın. |
Birden çok eşleşen satırı işleme
Bir sorgu birden fazla kayıtlı satır döndürebilir. Yöntem garantili bir sıralama, en son satır seçimi veya numara/önek filtresi sağlamaz. İlk veya son satırı sessizce seçmeyin. Döndürülen bağlamı, özgün olarak seçilen numara ve fiyat seçeneğiyle karşılaştırın; belirsiz veya güncelliğini yitirmiş kalırsa bu yanıtı bir sipariş teklifi olarak değerlendirmek yerine numara aramasını yenileyin.
Portalın sipariş inceleme iş akışı ek seçim ve geçerlilik denetimleri gerçekleştirir. Bu eski sorgunun söz konusu denetimleri uyguladığını veya portalın kabul ettiği her tanımlayıcıyı kabul ettiğini varsaymayın.
Boş yanıtlar ve hatalar
Eşleşen kayıtlı satır yoksa mevcut işleyici hiçbir JSON sonucu üretmez ve açık bir bulunamadı yanıtı da vermez. Boş bir gövde sıfır fiyat, kullanılabilir bir plan veya doğrulanmış başarılı bir sorgu anlamına gelmez. Hem HTTP yanıtını hem de JSON yapısını denetleyin; eksik veya ayrıştırılamayan fiyat verilerine dayanarak sipariş vermeyin.
Kimlik doğrulama, kaynak IP kısıtlamaları ve veritabanı arızaları da kullanılabilir bir yanıtı engelleyebilir. Veritabanı istisnası için işleyiciye özgü bir hata zarfı yoktur. Kimliği doğrulanmış bir sorgu kullanılamaz durumda kalmaya devam ederse seçiminizi yenileyin veya destekle iletişime geçin.
Etkiler ve sınırlar
İncelenen sorgu bir okuma sorgusu gerçekleştirir ve herhangi bir borçlandırma, satın alma, rezervasyon veya sağlayıcı fiyatı yenilemesi içermez. Kayıtlı fiyatlandırmayı okumak güncel envanteri, düzenleyici onayı, hesabın satın alma iznini veya nihai faturalandırmayı belirlemez.