Kā strādāt ar BILLmanager API

API ir programmatūras saskarne, kas ļauj vadīt jebkuru lietojumprogrammu, izmantojot komandu un funkciju kopumu. Piemēram, ir Yandex Music API, ar kuras palīdzību varat klausīties mūzikas ierakstus vietnē. Savā darbā mēs izmantojam norēķinu sistēmu BILLmanager.

Tai ir savs API, ar kura palīdzību var mērogot serverus pēc elastīgiem tarifiem, iegūt informāciju par maksājumiem un konta debetēšanu. Parasti jebkura API izstrādātāja tīmekļa vietnē ir pieejama detalizēta dokumentācija par to, kā instalēt un konfigurēt programmatūras saskarni.

Tomēr BILLmanager API dokumentāciju ir grūti apgūt. Ja vēlaties kļūt par profesionāli darbā ar API, ir pienācis laiks sākt pētīt dokumentāciju. Ja jums galvenais ir īsā laikā izpildīt uzdevumu un iegūt rezultātu, pietiek izmantot tālāk sniegtos norādījumus.

Parametru saraksts

Viens no pirmajiem jautājumiem, kas rodas, strādājot ar BILLmanager API, ir, kur iegūt parametru sarakstu? Visus parametrus darbam ar BILLmanager var atrast izstrādātāja dokumentācijā. Pilnu darba parametru sarakstu var atrast, izmantojot šo saiti.

Kā iegūt VDS sarakstu

Lai iegūtu VDS sarakstu, ir jāveic pieprasījums uz šādu URL adresi:

https://bill.pq.hosting/billmgr?func=vds&authinfo=username:password&out=JSONdata

Parametri pieprasījumā:

• authinfo - autorizācijas dati rēķinā;
• func - funkcija, kas izpildīta rēķinā;
• out - datu izvades formāts, tiek atbalstīti xml, json un JSONdata.

Visos pieprasījumos ir jāizmanto jūsu personas dati, tāpēc nomainiet username:password uz savu lietotājvārdu un paroli un pēc tam veiciet GET pieprasījumu, piemēram, izmantojot CURL.

Kā pasūtīt VDS

Lai pasūtītu VDS, jums ir jāveic pieprasījums uz šādu URL:

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

Parametri pieprasījumā:

• authinfo - autorizācijas dati rēķinā;
• func - funkcija, kas izpildīta rēķinā;
• addon_X - pasūtāmaispapildinājums (pēc izvēles), piemēram, lai pasūtītu vadības paneli vai IPv6 adreses;
• autoprolong - opcija, lai iespējotu vai aizliegtu automātisku servera atjaunošanu;
• ostempl - OS pasūtījuma šablons;
• period - pasūtījuma periods, tiek norādīts mēnešu skaits, tiek atbalstīti 1, 3, 6, 12 mēneši;
• pricelist - tarifu plāna ID;
• skipbasket - karodziņš - karodziņš iepirkumu groza izvietošanas posma izlaišanai, lai automātiski pasūtītu pakalpojumu;
• domain - serveradomēna nosaukums (nav obligāts);
• sok - pieprasījuma apstiprinājums.

Servera parametru maiņa

API virtuālā servera parametru maiņai:

https://bill.pq.hosting/billmgr?func=vds.edit&authinfo=username:password&addon_11=512&elid=958&domain=company.com&sok=ok

Lai mainītu īpašos servera parametrus:

https://bill.pq.hosting/billmgr?func=dedic.edit&authinfo=username:password&addon_26=10&addon_26=10&addon_28=5000&elid=1065&sok=ok

Parametri pieprasījumā:

• authinfo - autorizācijas dati rēķinā;
• func - funkcija, kas izpildīta rēķinā;
• elid - pakalpojuma kods;
• addon_X - maināmāaddon (nav obligāti), piemēram, lai mainītu IP adrešu skaitu;
• domain - domēna nosaukums (pēc izvēles);
• sok - pieprasījuma apstiprinājums.

Tarifu plāna papildinājumi, pasūtot vai mainot pakalpojumu, izmantojot API, tiek nodoti, izmantojot parametru addon_, kas iegūst vērtību addon_5=10, kur 5 ir papildinājuma kods, 10 ir vērtība.

Veicot API pieprasījumus, varat izmantot pārlūkprogrammas konsoli, cilnē "tīkls" varat redzēt, kādi pieprasījumi tiek veikti no pārlūkprogrammas, pasūtot serveri, šos pašus parametrus var nodot, izmantojot API pieprasījumus. Iepriekš minētajā sarakstā ir aprakstīti API pieprasījumu piemēri ar nepilnīgu funkciju un parametru sarakstu.

Darbs ar cikliem

Ja nepieciešams noņemt VDS, pievienot atmiņu vai procesora kodolus, to var izdarīt bez BILLmanager API. Tomēr 10, 100 VDS pasūtīšanas vai servera parametru masveida maiņas gadījumā šis process var aizņemt vairākas stundas. Šādos gadījumos ir ierasts izmantot ciklus:

#!/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

Piemērā izmantots API serveru pasūtīšanas pieprasījums, seq norāda pasūtāmo serveru skaitu. Serveru pasūtīšanas parametri ir līdzīgi viena servera pasūtīšanai, neizmantojot ciklus.

Pilnīga dokumentācija par darbu ar BILLmanager API no izstrādātāja ir pieejama šeit.