API, herhangi bir uygulamayı bir dizi komut ve işlev aracılığıyla kontrol etmenizi sağlayan bir yazılım arayüzüdür. Örneğin, sitedeki müzik parçalarını dinleyebileceğiniz Yandex Müzik API'si vardır. Çalışmamızda BILLmanager faturalandırma sistemini kullanıyoruz.
Esnek tarifelerde sunucuları ölçeklendirebileceğiniz, ödemeler ve hesap borçları hakkında bilgi alabileceğiniz kendi API'sine sahiptir. Kural olarak, herhangi bir API geliştiricisi, web sitesinde yazılım arayüzünün nasıl kurulacağı ve yapılandırılacağı konusunda ayrıntılı belgelere sahiptir.
Ancak, BILLmanager API belgelerinde ustalaşmak zordur. API ile çalışma konusunda profesyonel olmak istiyorsanız, belgeleri incelemeye başlamanın zamanı gelmiştir. Sizin için asıl önemli olan görevi tamamlamak ve sonucu kısa sürede almaksa, aşağıdaki talimatları kullanmanız yeterlidir.
BILLmanager API ile çalışırken ortaya çıkan ilk sorulardan biri parametrelerin listesinin nereden alınacağıdır? BILLmanager ile çalışmak için tüm parametreler geliştiricinin dokümantasyonunda bulunabilir. Çalışma parametrelerinin tam listesi bu bağlantıyı takip ederek bulunabilir.
VDS listesini almak için aşağıdaki URL'ye bir istekte bulunmanız gerekir:
https://bill.pq.hosting/billmgr?func=vds&authinfo=username:password&out=JSONdata
İstekteki parametreler:
authinfo
- faturalandırmadaki yetkilendirme verileri;func - faturalandırmada
yürütülen işlev;out
- veri çıktı formatı, xml, json ve JSONdata desteklenmektedir.Tüm isteklerde kişisel verilerinizi kullanmanız gerekir, bu nedenle kullanıcı adı:parola'yı kullanıcı adınız ve parolanız olarak değiştirin, ardından örneğin CURL kullanarak bir GET isteği yapın.
Bir VDS sipariş etmek için aşağıdaki URL'ye bir talepte bulunmanız gerekir:
https://bill.pq.hosting/billmgr?func=vds.order.param&authinfo=username:password&addon_10=6&addon_11=256&addon_12=500
&addon_13=1&addon_14=28&addon_15=0&addon_28=1&addon_7=5000&addon_9=5&autoprolong=1
&ostempl=ISPsystem%5F%5FCentOS%2D7%2Damd64&period=1&pricelist=6&skipbasket=on&domain=vds.test&sok=ok
İstekteki parametreler:
authinfo
- faturalandırmada yetkilendirme verileri;func - faturalandırmada
yürütülen işlev;addon_X
- sipariş edilecekeklenti
(isteğe bağlı), örneğin kontrol paneli veya IPv6 adresleri sipariş etmek için;autoprolong
- otomatik sunucu yenilemeyi etkinleştirme veya devre dışı bırakma seçeneği;ostempl
- sipariş için işletim sistemi şablonu;period
- sipariş dönemi, ay sayısı belirtilir, 1, 3, 6, 12 desteklenir; pricelist
- tarife planı kimliği;skipbasket
- hizmetin otomatik siparişi için alışveriş sepeti yerleştirme aşamasını atlama bayrağı;domain
- sunucununalan
adı (isteğe bağlı);sok
- istek onayı.Sanal sunucu parametrelerini değiştirmek için API:
https://bill.pq.hosting/billmgr?func=vds.edit&authinfo=username:password&addon_11=512&elid=958&domain=company.com&sok=ok
Özel sunucu parametrelerini değiştirmek için:
https://bill.pq.hosting/billmgr?func=dedic.edit&authinfo=username:password&addon_26=10&addon_26=10&addon_28=5000&elid=1065&sok=ok
İstekteki parametreler:
authinfo
- faturalandırmada yetkilendirme verileri;func
-faturalandırmada
yürütülen işlev;elid
- hizmet kodu;addon_X
- değiştirilecekeklenti
(isteğe bağlı), örneğin IP adreslerinin sayısını değiştirmek için;domain
- alan adı (isteğe bağlı);sok
- talep onayı.API aracılığıyla bir hizmet sipariş ederken veya değiştirirken tarife planına yapılan eklemeler, addon_5=10
değerini alan addon_
parametresi aracılığıyla iletilir; burada 5
, eklemenin kodu, 10
ise değerdir.
API istekleri yaparken tarayıcı konsolunu kullanabilirsiniz, "ağ" sekmesinde bir sunucu siparişi verirken tarayıcıdan hangi isteklerin yapıldığını görebilirsiniz, aynı parametreler API istekleri aracılığıyla iletilebilir. Yukarıdaki liste, eksik bir işlev ve parametre listesi ile API isteklerinin örneklerini açıklamaktadır.
VDS'yi kaldırmanız, bellek veya işlemci çekirdeği eklemeniz gerekiyorsa, bunu BILLmanager API'si olmadan yapabilirsiniz. Ancak, 10, 100 VDS sipariş edilmesi veya sunucu parametrelerinin toplu olarak değiştirilmesi durumunda, bu işlem birkaç saat sürebilir. Bu tür durumlar için döngü kullanmak gelenekseldir:
#!/bin/bash
seq 1 32 | while read line; do
curl -s -k "https://bill.pq.hosting/billmgr?func=vds.order.param&authinfo=username:password&addon_10=6&addon_11=256&addon_12=500
&addon_13=1&addon_14=28&addon_15=0&addon_28=1&addon_7=5000&addon_9=5&autoprolong=1
&ostempl=ISPsystem%5F%5FCentOS%2D7%2Damd64&period=1&pricelist=6&skipbasket=on&domain=vds.test$line&sok=ok"
done
Örnekte API sunucu sipariş isteği kullanılmaktadır, seq sipariş edilecek sunucu sayısını belirtir. Sunucu sipariş parametreleri, döngü kullanmadan tek bir sunucu sipariş etmeye benzer.
Geliştiriciden BILLmanager API ile çalışma hakkında tam dokümantasyon burada mevcuttur.
Apply the discount by inserting the promo code in the special field at checkout:
Apply the discount by inserting the promo code in the special field at checkout: