In questa intervista Rob Peters, ORCID's Director of Technology, presenta ORCIDla nuova API di: lanciata il 14 febbraio 2017
Prima di iniziare a parlare della nuova API, puoi parlarci un po' di ORCID's Team Tecnico e il tuo ruolo di Direttore?
A prima vista, il ORCID la squadra assomiglia molto a qualsiasi altra squadra tecnica. Abbiamo cinque sviluppatori, un amministratore di server, un analista di garanzia della qualità e, naturalmente, un manager (io). Tuttavia, dove diventa interessante è il nostro diverso background geografico, culturale e lavorativo. Tre di noi risiedono negli Stati Uniti, tre in Costa Rica e due nel Regno Unito, quindi geograficamente abbiamo molte prospettive. Inoltre, alcuni di noi provengono dalla consulenza software tradizionale, altri provengono dall'industria editoriale, dalle startup della "Silicon Valley" e dalle scienze bibliotecarie.
Il mio ruolo personale come Direttore della tecnologia è gestire lo sviluppo quotidiano del software. Ciò si riduce ad aiutare il mio team a comunicare tra loro e con il resto dell'organizzazione, oltre a gestire i compiti che il team svolge (e quali vengono rimandati). Ho anche l'opportunità di avere molti input su decisioni strategiche di livello superiore ORCID fa.
Passando alla versione API 2.0 - perché lo facciamo - ORCID, Nonché ORCID community: hai bisogno di questo aggiornamento?
Il primo ORCID API, lanciato nell'ottobre 2012, si basava inevitabilmente su molti presupposti che in seguito si sono rivelati errati e/o hanno richiesto un perfezionamento. Per servire meglio la comunità della ricerca, dobbiamo esaminare continuamente tali ipotesi. L'utilizzo di feedback, domande e analisi di prove che non erano disponibili prima del lancio ci ha fornito nuove informazioni su ciò che ORCID L'API dovrebbe e non dovrebbe essere. Come vedrai dalla mia risposta alla domanda successiva, la versione 2.0 rappresenta un'importante rottura rispetto ai presupposti su cui è stata costruita la 1.0, pur essendo abbastanza pragmatica da fornire continuità tra le due API.
Quali sono le principali differenze tra 1.2 e 2.0 e in che modo andranno a beneficio dei membri?
Nello sviluppo della 2.0, volevamo sia affrontare gli ostacoli che i membri hanno incontrato con la 1.2, sia introdurre nuove funzionalità che sappiamo che la comunità vuole.
Quindi, oltre ad affrontare problemi noti come la scalabilità nella gestione delle pubblicazioni iper-autori e le sfide con comportamenti impliciti che causavano confusione tra i membri, abbiamo anche aggiunto nuove funzionalità per supportare il riconoscimento della revisione tra pari, notifiche migliorate per gli utenti e la capacità di supporta quasi tutti identificatore persistente.
Per spiegare perché alcuni di questi cambiamenti erano necessari, diventerò un po' tecnico. Prima di iniziare a codificare una singola nuova riga, abbiamo creato un elenco di cose che volevamo vedere migliorate, con il seguente "manifesto":
- Smettila di pensare al ORCID registrare come un documento monolitico (grande singolo). Più istituzioni che scrivono ad an to ORCID record significa riconoscere che il record è multi-locatario. Inoltre, i ricercatori spesso producono così grandi quantità di ricerche che anche i riassunti di esse non si adattano a un documento monolitico.
- Ambiti semplificati. La granularità degli ambiti delle autorizzazioni nell'API 1.0 è schiacciante per tutte le parti coinvolte; semplificarli renderà la vita più facile sia agli sviluppatori che agli utenti.
- Esplicito Riposante comportamento. I comportamenti impliciti sono dannosi per gli implementatori poiché portano a comportamenti imprevisti che, a loro volta, confondono gli utenti finali. Utilizzando il comportamento RESTful, la nostra nuova API evita questi problemi.
- URL ragionevoli più brevi. Un buon esempio potrebbe essere /works/1234 è meglio di /orcid-opere/1234.
- Le chiamate all'elenco restituiscono solo riepiloghi. Per rendere più veloce la chiamata di un record, l'API 2.0 restituisce solo i riepiloghi per gli elenchi. Fare una chiamata per ogni informazione su un ricercatore non funziona per gli articoli iper-autori, dove ci sono decine, centinaia o addirittura migliaia di autori.
- Nomi comuni e strutture per elementi comuni. 2.0 ci consente di assicurarci che gli elementi comuni in XML/JSON abbiano gli stessi nomi.
- i codici di errore. Ora includiamo i codici di errore nel corpo della risposta quando l'errore non è completamente descritto da un codice HTTP standard.
E quali sono i vantaggi per gli utenti?
Alla fine della giornata, un'API dovrebbe essere perfetta per gli utenti. Un comportamento imprevisto 1.0 si manifesta e influisce sull'esperienza dell'utente, frustrando allo stesso tempo gli sviluppatori che stanno implementando l'API. A livello pratico, la nuova API consente di snellire ogni sezione del ORCID record per fornire in modo coerente l'applicazione delle impostazioni di visibilità, dell'origine e della data di creazione per gli elementi in ciascuna sezione.
Ciò influenzerà anche l'API pubblica? Come?
Sì. Le modifiche all'API membro e all'API pubblica sono sempre in sequenza. Sebbene apprezziamo e facciamo affidamento sul supporto dei membri, siamo anche impegnati nella nostra visione più ampia "di un mondo in cui tutti coloro che partecipano alla ricerca, alla borsa di studio e all'innovazione sono identificati in modo univoco e collegati ai loro contributi attraverso discipline, confini e tempo". Consideriamo l'API pubblica un mezzo per aiutare a raggiungere questo obiettivo.
Quali pensi saranno le sfide principali nell'implementazione della nuova versione e quale sarà il supporto ORCID fornire?
Il problema più difficile è mettere da parte le risorse per fare il lavoro per upgrade. Per alcune organizzazioni potrebbero essere necessari solo un paio di giorni, mentre altre potrebbero richiedere un mese intero. Indipendentemente dal lasso di tempo, non aver paura di raggiungere e chiedere aiuto, anche per un piccolo dettaglio che sta bloccando i tuoi progressi. Documentazione completa è ora disponibile per i membri.orcid.org e ORCID le organizzazioni membri possono anche CONTATTACI. Pubblicazione su Forum utenti API può essere utile, portando commenti da tutto il ORCID Comunità. Sono anche fermamente convinto di essere direttamente disponibile, quindi sentiti mandami un'email direttamente.
Chi sta attualmente utilizzando l'API 2.0 e che tipo di feedback ha fornito?
Ci impegniamo molto per rendere disponibili le release candidate al fine di ottenere feedback. CrossRef, Datacite, CERN e PTCRIS sono solo alcuni dei ORCID membri che hanno implementato una release candidate e fornito feedback. Inoltre, diverse organizzazioni hanno implementato la funzionalità di revisione tra pari utilizzando 2.0, inclusi i primi utenti, l'American Geophysical Union, F1000 e Publons. Il feedback ha incluso i soliti suggerimenti "tecnici" come i nomi utilizzati nello schema, la denominazione degli endpoint o i dibattiti sull'efficienza. Questo tipo di dettagli può avere grandi implicazioni per i membri. Tuttavia, gli implementatori dei candidati al rilascio forniscono anche feedback dal punto di vista del ricercatore, che riteniamo inestimabile.
Quanto tempo ORCID continuare a supportare la vecchia API?
Puntiamo al tramonto 1.2 alla fine del 2017. Indipendentemente dalla data del tramonto, se sei d'accordo con ORCIDla missione e la cura dei ricercatori interagiscono con ORCID ti consigliamo di passare a 2.0 ora.
C'è qualcos'altro che dovremmo sapere su questo cambiamento?
Speriamo che 2.0 si dimostri durevole e possiamo concentrarci su altre parti del ORCID stack tecnologico per un bel po'!
Per un riepilogo pratico e divertente delle funzionalità dell'API 2.0, consulta questo Ponte scivolo!