Slik jobber du med BILLmanager API

API er et programvaregrensesnitt som lar deg kontrollere ethvert program gjennom et sett med kommandoer og funksjoner. For eksempel er det Yandex Music API, takket være at du kan lytte til musikkspor på nettstedet. I vårt arbeid bruker vi faktureringssystemet BILLmanager.

Den har sin egen API, ved hjelp av hvilken du kan skalere servere til fleksible tariffer, få informasjon om betalinger og kontodebiter. Som regel har enhver API-utvikler detaljert dokumentasjon på nettstedet sitt om hvordan du installerer og konfigurerer programvaregrensesnittet.

BILLmanager API-dokumentasjonen er imidlertid vanskelig å mestre. Hvis du vil bli profesjonell i å jobbe med API, er det på tide å begynne å studere dokumentasjonen. Hvis det viktigste for deg er å fullføre oppgaven og få resultatet på kort tid, er det nok å bruke instruksjonene nedenfor.

Liste over parametere

Et av de første spørsmålene som oppstår når du arbeider med BILLmanager API er hvor du kan få listen over parametere? Alle parametere for å jobbe med BILLmanager finner du i dokumentasjonen fra utvikleren. Den fullstendige listen over arbeidsparametere finner du ved å følge denne lenken.

Hvordan få listen over VDS

For å få listen over VDS, må du sende en forespørsel til følgende URL:

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

Parametere i forespørselen:

• authinfo - autorisasjonsdata i fakturering;
• func - funksjon utført i fakturering;
• out - datautdataformat, xml, json og JSONdata støttes.

I alle forespørsler må du bruke dine personlige data, så endre brukernavn:passord til innlogging og passord, og gjør deretter en GET-forespørsel, for eksempel ved hjelp av CURL.

Hvordan bestille VDS

For å bestille en VDS må du sende en forespørsel til følgende 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

Parametere i forespørselen:

• authinfo - autorisasjonsdata i fakturering;
• func - funksjon utført i fakturering;
• addon_X -tillegg som skal bestilles (valgfritt), for eksempel for å bestille kontrollpanel eller IPv6-adresser;
• autoprolong - alternativ for å aktivere eller deaktivere automatisk serverfornyelse;
• ostempl - OS-mal for bestillingen;
• periode - bestillingsperiode, antall måneder er spesifisert, 1, 3, 6, 12 støttes;
• pricelist - tariffplan-ID;
• skipbasket - flagg for å hoppe over stadiet med plassering av handlekurv, for automatisk bestilling av tjenesten;
• domain - domenenavn på serveren (valgfritt);
• sok - bekreftelse på forespørsel.

Endring av serverparametere

API for endring av virtuelle serverparametere:

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

For å endre dedikerte serverparametere:

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

Parametere i forespørselen:

• authinfo - autorisasjonsdata i fakturering;
• func - funksjon utført i fakturering;
• elid - tjenestekode;
• addon_X - addon som skal endres (valgfritt), for eksempel for å endre antall IP-adresser;
• domain - domenenavn (valgfritt);
• sok - forespørsel om bekreftelse.

Tillegg til takstplanen når du bestiller eller endrer en tjeneste via API sendes gjennom addon_-parameteren, som tar verdien addon_5=10, der 5 er koden for tillegget, 10 er verdien.

Når du gjør API-forespørsler, kan du bruke nettleserkonsollen, på fanen "nettverk" kan du se hvilke forespørsler som blir gjort fra nettleseren når du bestiller en server, de samme parametrene kan sendes gjennom API-forespørsler. Listen ovenfor beskriver eksempler på API-forespørsler, med en ufullstendig liste over funksjoner og parametere.

Arbeide med sykluser

Hvis du trenger å fjerne VDS, legge til minne eller prosessorkjerner, kan du gjøre det uten BILLmanager API. Men i tilfelle bestilling av 10, 100 VDS eller masseendring av serverparametere, kan denne prosessen ta flere timer. Det er vanlig å bruke sykluser i slike tilfeller:

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

Eksemplet bruker API-serverbestillingsforespørsel, seq spesifiserer antall servere som skal bestilles. Serverbestillingsparametere ligner på bestilling av en enkelt server uten bruk av sløyfer.

Full dokumentasjon om hvordan du arbeider med BILLmanager API fra utvikleren er tilgjengelig her.