Is comhéadan bogearraí é API a ligeann duit aon fheidhmchlár a rialú trí shraith orduithe agus feidhmeanna. Mar shampla, tá an Yandex Music API, a bhuíochas sin is féidir leat éisteacht le cumadóireachta ceoil ar an suíomh. Bainimid úsáid as billeáil BILLmanager inár gcuid oibre.
Tá a API féin aige, lenar féidir leat freastalaithe a scála ar rátaí solúbtha, faisnéis a fháil faoi íocaíochtaí, dochair ó do chuntas. De ghnáth bíonn doiciméadú mionsonraithe ag aon fhorbróir API ar an suíomh Gréasáin chun an comhéadan bogearraí a shuiteáil agus a chumrú.
Mar sin féin, tá sé deacair doiciméadú BILLmanager API a thuiscint. Más mian leat a bheith i do API pro, ansin tá sé in am tosú ag déanamh staidéir ar an doiciméadú. Más é an rud is mó duit an tasc a chríochnú agus torthaí a fháil i mbeagán ama, is leor na treoracha a úsáidfimid thíos.
Ceann de na chéad cheisteanna a thagann chun cinn agus tú ag obair leis an BILLmanager API ná cá bhfaighidh tú liosta na bparaiméadar? Is féidir na paraiméadair go léir le haghaidh oibriú le BILLmanager a fháil sa doiciméadú ón bhforbróir. Is féidir liosta iomlán de pharaiméadair oibriúcháin a fháil ach an nasc seo a leanúint.
Chun liosta VDS a fháil, ní mór duit iarratas a dhéanamh chuig an URL seo a leanas:
https://bill.pq.hosting/billmgr?func=vds&authinfo=username:password&out=JSONdata
Paraiméadair san iarratas:
authinfo
— sonraí údaraithe sa bhilleáil;func
— feidhm a dhéantar i mbilleáil;out
- tacaítear le formáid aschuir sonraí, xml, json agus JSONdata.I ngach iarratas ní mór duit do shonraí pearsanta a úsáid, mar sin athraigh ainm úsáideora:pasfhocal chuig d'ainm úsáideora agus do phasfhocal, ansin déan iarratas GET, mar shampla, ag baint úsáide as CURL.
Chun VDS a ordú, ní mór duit iarratas a dhéanamh chuig an URL seo a leanas:
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
Paraiméadair san iarratas:
authinfo
— sonraí údaraithe sa bhilleáil;func
— feidhm a dhéantar i mbilleáil;addon_X
- Chomh maith leis an ordú (roghnach), mar shampla, le haghaidh ordú painéal rialaithe nó seoltaí IPv6;autoprolong
- rogha chun síneadh uathoibríoch an fhreastalaí a chumasú nó a dhíchumasú;ostempl
- teimpléad OS le haghaidh ordú;period
— tréimhse ordaithe, léirítear líon na míonna, tacaítear le 1, 3, 6, 12;pricelist
— ID plean taraife;skipbasket
– bratach chun gan bacadh le céim an tseiceáil amach bascaed chun seirbhísí a ordú go huathoibríoch;domain
- ainm fearainn an fhreastalaí (roghnach);sok
- dearbhú ar an iarratas.API chun paraiméadair freastalaí fíorúla a athrú:
https://bill.pq.hosting/billmgr?func=vds.edit&authinfo=username:password&addon_11=512&elid=958&domain=company.com&sok=ok
Chun socruithe freastalaí tiomnaithe a athrú:
https://bill.pq.hosting/billmgr?func=dedic.edit&authinfo=username:password&addon_26=10&addon_26=10&addon_28=5000&elid=1065&sok=ok
Paraiméadair san iarratas:
authinfo
— sonraí údaraithe sa bhilleáil;func
— feidhm a dhéantar i mbilleáil;elid
- cód seirbhíse;addon_X
— suimiú le haghaidh athruithe (roghnach), mar shampla, chun líon na seoltaí IP a athrú;domain
- ainm fearainn (roghnach);sok
- dearbhú ar an iarratas.Tarchuirtear breisithe plean taraife nuair a bhíonn seirbhís á ordú nó á athrú trí API trí an paraiméadar addon_
, a thógann an luach addon_5=10
, áit arb é 5
an cód breiseáin, is é 10
an luach.
Agus iarratais API á gcomhdhéanamh, is féidir leat an consól brabhsálaí a úsáid; ar an táb “líonra”, is féidir leat a fheiceáil cad iad na hiarratais a dhéantar ón mbrabhsálaí nuair a bhíonn freastalaí á ordú; Déanann an liosta thuas cur síos ar shamplaí d'iarratais API, le liosta páirteach feidhmeanna agus paraiméadair.
Más gá duit VDS a bhaint, croíthe cuimhne nó próiseálaí a chur leis, is féidir é seo a dhéanamh gan BILLmanager API. Mar sin féin, i gcás 10, 100 VDS nó athruithe mais i bparaiméadar an fhreastalaí a ordú, féadfaidh an próiseas seo roinnt uaireanta a ghlacadh. I gcásanna den sórt sin, is coitianta lúba a úsáid:
#!/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
Úsáideann an sampla iarratas API chun freastalaí a ordú; léiríonn seq líon na bhfreastalaithe atá le hordú. Tá na paraiméadair chun freastalaí a ordú cosúil le freastalaí amháin a ordú gan timthriallta a úsáid.
Tá doiciméadú iomlán ar oibriú leis an BILLmanager API ón bhforbróir curtha i láthair anseo .
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: