L'API 3.0 è la versione API predefinita e ti consigliamo di utilizzare questa versione quando crei nuove integrazioni. Continueremo a supportare API 2.0 e 2.1 per il prossimo futuro e forniremo un preavviso di almeno 12 mesi prima di disattivare tali versioni.
Abbiamo imparato molto durante la transizione dall'API 1.2 all'API 2. Questa volta abbiamo reso l'aggiornamento molto più semplice da gestire. L'API 3.0 aggiunge nuove funzionalità modificando solo le funzionalità esistenti quando assolutamente necessario. Ciò significa che gli integratori dovrebbero essere in grado di passare alla nuova API con il minimo sforzo. Significa anche che, sebbene ti consigliamo di iniziare a pianificare il tuo aggiornamento il prima possibile in modo che la tua organizzazione e i tuoi ricercatori possano beneficiare delle nuove funzionalità, hai molta flessibilità nel decidere quando aggiornare alla 3.0.
Il piccolo elenco di modifiche potenzialmente importanti si trova nelle nostre note sulla versione dell'API qui e qui. Ci sono alcune modifiche ai campi facoltativi/obbligatori, le enumerazioni JSON sono state leggermente modificate e abbiamo anche un piccolo refactoring dei nostri schemi XML, aggiungendo alcuni nuovi campi per contenere i metadati richiesti per la nuova funzionalità.