[vpsFree.cz: community-list] vpsAdmin API a další směr vývoje

[Jakub Skokan]

Zdravím,

na adrese https://api.vpsfree.cz je k dispozici vývojová verze vpsAdmin 
API. Je to ve stavu, kdy to funguje, ale není to doladěné a nemá to 
všechny funkce.

Při vývoji vzniknul framework HaveAPI [1], který naše API využívá. Jedná 
se o framework na tvorbu sebepopisujících se RESTful API.

Sebepopisující se API odpovídá na HTTP metodu OPTIONS a vrací JSON 
obsahující seznam dostupných verzí API, objektů, akcí, jejich 
vstupních/výstupních parametrů, popis, validaci, ukázku použítí, apod. 
Díky této vlastnosti lze vytvořit klienta, který dokáže komunikovat s 
jakýmkoli API, které je postavené nad HaveAPI. Změny v API se okamžitě 
projeví ve všech klientech, atd.

Dokumentace API:
   - Automaticky generovaná frameworkem na https://api.vpsfree.cz

Co to zatím umí:
   - Vytvoření a smazání playground VPS,
   - seznam vlastních VPS, start, stop, restart, změna hesla, přeinstalace,
   - výpis konfigurace VPS,
   - seznam IP adres VPS,
   - seznam dostupných dstribucí (nutné k vytvoření VPS).

Připravení klienti:
   - CLI a klient v Ruby (>= 2.0) [2], který také existuje v obecné 
formě (pro jakékoliv API, rozdíl je pouze ve jménu a výchozí URL) [3],
   - PHP klient [4] a jeho obecná forma  [5].

Návody na instalaci a použití jednotlivých klientů jsou na přiložených 
odkazech.

Aktivita je vítána. Hodilo by se, kdyby se našlo pár lidí, co by udělali 
klienta ve svém oblíbeném jazyce. Nejvíc by se nám hodil alespoň 
proof-of-concept v JS, abychom si ověřili, že je možné udělat UI 
kompletně v HTML5 & JS, já už na to aktuálně nemám čas.

Pokud nenarazíme na nějaké větší problémy, aplikační logika vpsAdminu se 
bude postupně přesouvat z webového rozhraní do tohoto API. Současně se z 
vpsAdminu pomalu bude stávat nezávislý projekt na vpsFree.cz, aby jeho 
použití nebylo limitováno naším sdružením a šel nasadit i jinde.

Do budoucna se počítá s tím, že přes API půjde hýbat s parametry VPS a 
člen si bude moci rozdělit přidělené prostředky mezi více VPS jak se mu 
zlíbí (v rozumných mantinelech).

Rozhodli jsme se to spustit a oznámit co nejdříve, i když nekompletní, 
aby se koncept otestoval v praxi. Budu rád za jakoukoliv zpětnou vazbu, 
nápady či připomínky.

[1] https://github.com/vpsfreecz/haveapi

[2] https://github.com/vpsfreecz/vpsfree-client

[3] https://github.com/vpsfreecz/haveapi-client

[4] https://github.com/vpsfreecz/haveapi-client-php/tree/vpsfree

[5] https://github.com/vpsfreecz/haveapi-client-php

-- 
S pozdravem

Jakub Skokan

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.vpsfree.cz/pipermail/community-list/attachments/20140520/7d5a3a57/attachment-0002.html>