Klientų sistemos API: Skirtumas tarp puslapio versijų
| 1 eilutė: | 1 eilutė: | ||
| − | + | = Prisijungimas prie API = | |
Klientų sistemos programavimo sąsaja (API) skirta veiksmų su paslaugomis automatizavimui bei integravimui į trečųjų šalių sistemas. Prisijungimas prie API vyksta per HTTPS protokolą, rezultatai grąžinami [http://en.wikipedia.org/wiki/JSON JSON] formatu. | Klientų sistemos programavimo sąsaja (API) skirta veiksmų su paslaugomis automatizavimui bei integravimui į trečųjų šalių sistemas. Prisijungimas prie API vyksta per HTTPS protokolą, rezultatai grąžinami [http://en.wikipedia.org/wiki/JSON JSON] formatu. | ||
| 24 eilutė: | 24 eilutė: | ||
'''SVARBU!''' Prisijungimas prie API galimas tik iš IV potinklių, t.y. iš pas mus talpinamų serverių. API šiuo metu yra '''beta''' stadijos, todėl gali pasitaikyti tam tikrų klaidų, komandų ir resultatų formatas laikui bėgant gali keistis, iki 1.0 versijos šis puslapis bus vieninteliu informacijos apie naudojimasi API šaltiniu. Papildoma techninė pagalba API klausimais šiuo metu nėra teikiama. | '''SVARBU!''' Prisijungimas prie API galimas tik iš IV potinklių, t.y. iš pas mus talpinamų serverių. API šiuo metu yra '''beta''' stadijos, todėl gali pasitaikyti tam tikrų klaidų, komandų ir resultatų formatas laikui bėgant gali keistis, iki 1.0 versijos šis puslapis bus vieninteliu informacijos apie naudojimasi API šaltiniu. Papildoma techninė pagalba API klausimais šiuo metu nėra teikiama. | ||
| − | + | = Specialus API naudotojas = | |
Norėdami jungtis prie klientų sistemos per API, turėsite sukurti specialų API naudotoją. Tam klientų sistemoje apsilankykite naudotojų tvarkymo puslapyje: | Norėdami jungtis prie klientų sistemos per API, turėsite sukurti specialų API naudotoją. Tam klientų sistemoje apsilankykite naudotojų tvarkymo puslapyje: | ||
| 32 eilutė: | 32 eilutė: | ||
Ir sukurkite papildomą naudotoją su aprašymu "API" (be kabučių). Su šio naudotojo prisijungimo duomenimis galėsite jungtis prie API, tačiau ne prie klientų sistemos. | Ir sukurkite papildomą naudotoją su aprašymu "API" (be kabučių). Su šio naudotojo prisijungimo duomenimis galėsite jungtis prie API, tačiau ne prie klientų sistemos. | ||
| − | + | = API naudojimo pavyzdys = | |
Trumpas PHP kodo pavyzdys, iliustruojantis naudojimąsi API: | Trumpas PHP kodo pavyzdys, iliustruojantis naudojimąsi API: | ||
| 51 eilutė: | 51 eilutė: | ||
</pre> | </pre> | ||
| − | + | = API komandos = | |
| − | + | == Bendros paskyros komandos == | |
| − | + | === version === | |
Parametrų nėra. | Parametrų nėra. | ||
| 63 eilutė: | 63 eilutė: | ||
* API versijos numeris. | * API versijos numeris. | ||
| − | + | === account_info === | |
Parametrų nėra. | Parametrų nėra. | ||
| 71 eilutė: | 71 eilutė: | ||
* Kliento paskyros informacija, kartu su permokos ir premijos likučiu. | * Kliento paskyros informacija, kartu su permokos ir premijos likučiu. | ||
| − | + | === account_orders === | |
Parametrų nėra. | Parametrų nėra. | ||
| 79 eilutė: | 79 eilutė: | ||
* Išrašytų sąskaitų sąrašas, kartu su apmokėjimo būsena, suma, nuoroda spausdinimui. | * Išrašytų sąskaitų sąrašas, kartu su apmokėjimo būsena, suma, nuoroda spausdinimui. | ||
| − | + | === account_services === | |
Parametrų nėra. | Parametrų nėra. | ||
| 87 eilutė: | 87 eilutė: | ||
* Aktyvuotų paslaugų sąrašas, su galiojimo datom, kainom, pavadinimais. | * Aktyvuotų paslaugų sąrašas, su galiojimo datom, kainom, pavadinimais. | ||
| − | + | === account_credits === | |
Parametrai: | Parametrai: | ||
| 97 eilutė: | 97 eilutė: | ||
* Pridėtų ir panaudotų permokų išrašas. | * Pridėtų ir panaudotų permokų išrašas. | ||
| − | + | === account_bonuses === | |
Parametrai: | Parametrai: | ||
| 107 eilutė: | 107 eilutė: | ||
* Pridėtų ir panaudotų premijų išrašas su detalia informacija (SMS turinys, paslaugos pavadinimas). | * Pridėtų ir panaudotų premijų išrašas su detalia informacija (SMS turinys, paslaugos pavadinimas). | ||
| − | + | == Dedikuoto serverio valdymo komandos == | |
| − | + | === server_info === | |
Parametrai: | Parametrai: | ||
| 119 eilutė: | 119 eilutė: | ||
* Informacija apie serverį, serverio resursų (RAM, HDD) sunaudojimą (atnaujinama kas 1 val.) | * Informacija apie serverį, serverio resursų (RAM, HDD) sunaudojimą (atnaujinama kas 1 val.) | ||
| − | + | === server_tasks === | |
Parametrai: | Parametrai: | ||
| 132 eilutė: | 132 eilutė: | ||
* Informacija apie vykdomas arba įvykdytas serverio užduotis (pvz., perkrovimas). | * Informacija apie vykdomas arba įvykdytas serverio užduotis (pvz., perkrovimas). | ||
| − | + | === server_graphs === | |
Parametrai: | Parametrai: | ||
| 144 eilutė: | 144 eilutė: | ||
* Nuorodos į serverio grafikus (tinklo, CPU, RAM ir kt.) | * Nuorodos į serverio grafikus (tinklo, CPU, RAM ir kt.) | ||
| − | + | === server_os === | |
Parametrai: | Parametrai: | ||
| 154 eilutė: | 154 eilutė: | ||
* Sąrašas operacinių sistemų, kurias galima įdiegti į serverį. | * Sąrašas operacinių sistemų, kurias galima įdiegti į serverį. | ||
| − | + | === server_reboot === | |
Parametrai: | Parametrai: | ||
| 164 eilutė: | 164 eilutė: | ||
* '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | * '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | ||
| − | + | === server_recreate === | |
Parametrai: | Parametrai: | ||
| 175 eilutė: | 175 eilutė: | ||
* '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | * '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | ||
| − | + | === server_reset_password === | |
Parametrai: | Parametrai: | ||
| 185 eilutė: | 185 eilutė: | ||
* '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | * '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | ||
| − | + | === server_change === | |
Parametrai: | Parametrai: | ||
| 199 eilutė: | 199 eilutė: | ||
* '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | * '''task_id''' - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę. | ||
| − | + | === server_domain === | |
Parametrai: | Parametrai: | ||
15:02, 5 lapkričio 2012 versija
Turinys
Prisijungimas prie API
Klientų sistemos programavimo sąsaja (API) skirta veiksmų su paslaugomis automatizavimui bei integravimui į trečųjų šalių sistemas. Prisijungimas prie API vyksta per HTTPS protokolą, rezultatai grąžinami JSON formatu.
Užklausos formatas:
https://api.iv.lt/json.php ?nick=<prisijungimo vardas> &password=<slaptažodis> &command=<komanda> &id=<paslaugos id> &...=<kiti parametrai>
Parametrų paaiškinimai:
- prisijungimo vardas - specialaus API naudotojo vardas
- slaptažodis - specialaus API naudotojo slaptažodis
- komanda - komanda vykdymui, pvz., "version" arba "account_info"
- id - paslaugos ID, kurį galite rasti per klientų sistemą paslaugos valdymo puslapyje, arba per API paslaugų sąraše
- kiti parametrai - papildomi parametrai, priklausomai nuo konkrečios komandos
SVARBU! Prisijungimas prie API galimas tik iš IV potinklių, t.y. iš pas mus talpinamų serverių. API šiuo metu yra beta stadijos, todėl gali pasitaikyti tam tikrų klaidų, komandų ir resultatų formatas laikui bėgant gali keistis, iki 1.0 versijos šis puslapis bus vieninteliu informacijos apie naudojimasi API šaltiniu. Papildoma techninė pagalba API klausimais šiuo metu nėra teikiama.
Specialus API naudotojas
Norėdami jungtis prie klientų sistemos per API, turėsite sukurti specialų API naudotoją. Tam klientų sistemoje apsilankykite naudotojų tvarkymo puslapyje:
https://klientams.iv.lt/users.php
Ir sukurkite papildomą naudotoją su aprašymu "API" (be kabučių). Su šio naudotojo prisijungimo duomenimis galėsite jungtis prie API, tačiau ne prie klientų sistemos.
API naudojimo pavyzdys
Trumpas PHP kodo pavyzdys, iliustruojantis naudojimąsi API:
$nick = "prisijungimo vardas"; $password = "slaptažodis"; $server_id = "serverio paslaugos ID"; $api_url = "https://api.iv.lt/json.php?nick=$nick&password=$password&command="; $account = json_decode(file_get_contents($api_url."account_info")); $bonuses = json_decode(file_get_contents($api_url."account_bonuses&count=100")); print_r($account); // atspausdina informaciją apie kliento paskyrą print_r($bonuses); // atspausdina informaciją apie kliento paskutines gautas premijas (max 100) file_get_contents($api_url."server_reboot&id=$server_id"); // perkrauna serverį
API komandos
Bendros paskyros komandos
version
Parametrų nėra.
Rezultatas:
- API versijos numeris.
account_info
Parametrų nėra.
Rezultatas:
- Kliento paskyros informacija, kartu su permokos ir premijos likučiu.
account_orders
Parametrų nėra.
Rezultatas:
- Išrašytų sąskaitų sąrašas, kartu su apmokėjimo būsena, suma, nuoroda spausdinimui.
account_services
Parametrų nėra.
Rezultatas:
- Aktyvuotų paslaugų sąrašas, su galiojimo datom, kainom, pavadinimais.
account_credits
Parametrai:
- count - kiek paskutinių įrašų grąžinti (max 1000).
Rezultatas:
- Pridėtų ir panaudotų permokų išrašas.
account_bonuses
Parametrai:
- count - kiek paskutinių įrašų grąžinti (max 1000).
Rezultatas:
- Pridėtų ir panaudotų premijų išrašas su detalia informacija (SMS turinys, paslaugos pavadinimas).
Dedikuoto serverio valdymo komandos
server_info
Parametrai:
- id - paslaugos ID.
Rezultatas:
- Informacija apie serverį, serverio resursų (RAM, HDD) sunaudojimą (atnaujinama kas 1 val.)
server_tasks
Parametrai:
- id - paslaugos ID.
- task_id - užduoties ID (neprivalomas).
- task - užduoties pavadinimas (neprivalomas).
- count - kiek paskutinių įrašų grąžinti (max 1000).
Rezultatas:
- Informacija apie vykdomas arba įvykdytas serverio užduotis (pvz., perkrovimas).
server_graphs
Parametrai:
- id - paslaugos ID.
- width - grafikų plotis pikseliais (max 1000).
- ip - naudotojo IP, iš kurio bus peržiūrimi grafikai.
Rezultatas:
- Nuorodos į serverio grafikus (tinklo, CPU, RAM ir kt.)
server_os
Parametrai:
- id - paslaugos ID.
Rezultatas:
- Sąrašas operacinių sistemų, kurias galima įdiegti į serverį.
server_reboot
Parametrai:
- id - paslaugos ID.
Rezultatas:
- task_id - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę.
server_recreate
Parametrai:
- id - paslaugos ID.
- os - operacinės sistemos ID (pvz., centos-6-x86_64).
Rezultatas:
- task_id - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę.
server_reset_password
Parametrai:
- id - paslaugos ID.
Rezultatas:
- task_id - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę.
server_change
Parametrai:
- id - paslaugos ID.
- cpu - procesorius GHz (2..16)
- ram - atmintis MB (2048..16384)
- quota - disko vieta GB (20..800)
- bandwidth - pralaidumas Mbps (20..400)
Rezultatas:
- task_id - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę.
server_domain
Parametrai:
- id - paslaugos ID.
- domain - naujas serverio hostname.
Rezultatas:
- task_id - užduoties ID, pagal kurį galima sekti užduoties vykdymo būklę.
