Så här arbetar du med BILLmanager API

API är ett programvarugränssnitt som låter dig styra alla applikationer genom en uppsättning kommandon och funktioner. Till exempel finns det Yandex Music API, tack vare vilket du kan lyssna på musikspår på webbplatsen. I vårt arbete använder vi faktureringssystemet BILLmanager.

Den har sitt eget API, med hjälp av vilket du kan skala servrar till flexibla taxor, få information om betalningar och kontodebiteringar. Som regel har alla API-utvecklare detaljerad dokumentation på sin webbplats om hur man installerar och konfigurerar programvarugränssnittet.

BILLmanager API-dokumentation är dock svår att behärska. Om du vill bli professionell när du arbetar med API: et är det dags att börja studera dokumentationen. Om det viktigaste för dig är att slutföra uppgiften och få resultatet på kort tid räcker det att använda instruktionerna nedan.

Lista över parametrar

En av de första frågorna som uppstår när man arbetar med BILLmanager API är var man kan få listan över parametrar? Alla parametrar för att arbeta med BILLmanager finns i dokumentationen från utvecklaren. Den fullständiga listan över arbetsparametrar kan hittas genom att följa den här länken.

Hur man får listan över VDS

För att få listan över VDS måste du göra en begäran till följande URL:

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

Parametrar i begäran:

• authinfo - behörighetsdata i fakturering;
• func - funktion som utförts i fakturering;
• out - datautmatningsformat, xml, json och JSONdata stöds.

I alla begäranden måste du använda dina personuppgifter, så ändra användarnamn:lösenord till din inloggning och ditt lösenord och gör sedan en GET-begäran, till exempel med CURL.

Hur man beställer VDS

För att beställa en VDS måste du göra en begäran till följande 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

Parametrar i begäran:

• authinfo - behörighetsdata i fakturering;
• func - funktion som utförts i fakturering;
• addon_X -tillägg att beställa (valfritt), t.ex. att beställa kontrollpanel eller IPv6-adresser;
• autoprolong - alternativ för att aktivera eller inaktivera automatisk serverförnyelse;
• ostempl - OS-mall för beställningen;
• period - orderperiod, antalet månader anges, 1, 3, 6, 12 stöds;
• pricelist - ID för tariffplan;
• skipbasket - flagga för att hoppa över steget för utcheckning av kundvagn, för automatisk beställning av tjänsten;
• domain - servernsdomännamn (valfritt);
• sok - bekräftelse på begäran.

Ändra serverparametrar

API för att ändra parametrar för virtuella servrar:

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

För att ändra dedikerade serverparametrar:

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

Parametrar i begäran:

• authinfo - behörighetsdata i fakturering;
• func - utförd funktion i fakturering;
• elid - servicekod;
• addon_X - addon som ska ändras (valfritt), till exempel för att ändra antalet IP-adresser;
• domain -domännamn (valfritt);
• sok - bekräftelse på begäran.

Tillägg till tariffplanen när du beställer eller ändrar en tjänst via API skickas via parametern addon_, som har värdet addon_5=10, där 5 är koden för tillägget och 10 är värdet.

När du gör API-förfrågningar kan du använda webbläsarkonsolen, på fliken "nätverk" kan du se vilka förfrågningar som görs från webbläsaren när du beställer en server, samma parametrar kan skickas via API-förfrågningar. Listan ovan beskriver exempel på API-förfrågningar, med en ofullständig lista över funktioner och parametrar.

Arbeta med cykler

Om du behöver ta bort VDS, lägga till minne eller processorkärnor kan du göra det utan BILLmanager API. Men om du beställer 10, 100 VDS eller massändring av serverparametrar kan den här processen ta flera timmar. Det är vanligt att använda cykler för sådana fall:

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

I exemplet används API-serverorderbegäran, seq anger antalet servrar som ska beställas. Parametrarna för serverbeställning liknar beställning av en enda server utan att använda loopar.

Fullständig dokumentation om hur man arbetar med BILLmanager API från utvecklaren finns här.