martedì 28 ottobre 2014

Visual Studio Online REST API versione 1.0

Oggi è stata rilasciata la prima versione ufficiale delle REST API di Visual Studio Online, la 1.0.

Annunciate in preview in maggio, ora hanno raggiunto una maturità tale da spingere il team di sviluppo a chiudere la prima release. Questo non significa che non ci saranno cambiamenti o che gli sviluppi siano terminati; significa che le funzionalità core sono ora complete e da qui in avanti verranno versionate per mantenere  la compatibilità all'indietro, in modo che tutte le applicazioni ed i servizi che le utilizzano rimangano comunque funzionanti a prescindere dagli aggiornamenti futuri.

Congiuntamente all'annuncio, il team ha modificato il "API Reference portal" e la "Getting started guide"

Importante
Se avete delle applicazioni esistenti che utilizzano la versione 1.0 preview delle API, dovreste iniziare la migrazione alla  release 1.0 prima possibile; infatti la versione 1.0 preview (e precedenti) smetteranno di funzionare in 12 settimane da oggi. Per sapere di più sul versioning e sulla migrazione è possibile consultare la "versioning and migration page".

Detto questo, ricordate che a partire da oggi, quindi, le Visual Studio Online REST API seguono questo pattern:

VERB https://{account}.VisualStudio.com/DefaultCollection/_apis[/{area}]/{resource}?api-version=1.0

Nessun commento: