Luglio segna il quinto mese dalla nostra uscita ORCID API v2.0e siamo lieti di segnalare che molti utenti dell'API Public e Member hanno già eseguito l'upgrade o stanno per farlo. Per incoraggiare quelli di voi che non hanno ancora iniziato l'aggiornamento, vorremmo evidenziare alcune delle funzionalità della v2.0 che semplificherà i tuoi flussi di lavoro, ridurrà le dimensioni dei file di trasferimento e renderà il tuo ORCID l'integrazione funziona meglio per te e per i tuoi utenti.
Meno ambiti, meno confusione
La nostra vecchia API ti permetteva di richiedere molto permessi dagli utenti: permesso di creare elementi in una sezione, leggere quella stessa sezione e aggiornarla. La richiesta di autorizzazioni separate per ogni sezione ha prodotto un elenco di richieste che hanno confuso gli utenti.
Nell'API v2.0 abbiamo consolidato i nostri scopi in tre, che consentono di richiedere l'accesso in lettura (limitato) e in aggiornamento a tutte le sezioni del ORCID record.
Hai ancora quei token con le autorizzazioni precedenti? Non preoccuparti: continueranno a funzionare ai livelli di accesso per i quali sono stati originariamente emessi. Ma potresti voler creare un flusso di lavoro per richiedere che gli utenti aggiornino le loro autorizzazioni se il tuo sistema aggiornato ha nuove funzionalità che comportano l'accesso ad altre sezioni del loro record.
Leggi e aggiorna per articolo
Utilizzando le versioni precedenti dell'API, se il tuo sistema aveva bisogno di aggiungere un nuovo lavoro singolo su un record al quale erano stati aggiunti più lavori, allora doveva aggiornare l'intera sezione dei lavori, incluso il nuovo lavoro e tutti i lavori aggiunti in precedenza. Di conseguenza, l'aggiornamento di un singolo elemento in un record implicava l'invio di un file potenzialmente di grandi dimensioni di altri elementi che non presentava modifiche o la perdita di tutti gli elementi in quella sezione o persino l'intero record.
v2.0 ha semplificato questo processo di gestire gli articoli su base individuale. Il tuo sistema può aggiungi un'opera singola ad un ORCID record, quindi modifica o elimina quel singolo lavoro. Questo viene fatto implementando mettere i codici per i singoli articoli sul ORCID Registro. Ad esempio, se il tuo sistema aggiunge una nuova affiliazione lavorativa a un ORCID registrare, il ORCID L'API restituisce un messaggio di conferma insieme al codice put che il sistema può utilizzare per aggiornare o eliminare solo quell'elemento. In generale, è possibile aggiungere, modificare o eliminare un solo elemento alla volta su un ORCID record. L'unica eccezione sono le opere, che per molti ricercatori costituiscono la maggior parte della loro ORCID disco. L'API v2.0 consente ai tuoi sistemi di leggi fino a 50 opere alla volta, e per aggiungere fino a 100 opere Al tempo. La modifica o l'eliminazione dei lavori deve ancora essere eseguita in base all'elemento.
I codici put sono retroattivi: agli elementi aggiunti in 1.2 e precedenti sono stati assegnati codici put. Mentre lavori per aggiornare il tuo sistema alla v2.0, ricorda di aggiungere un campo per il suo codice put corrispondente. Puoi interrogare e ORCID record per ottenere i codici put di tutti gli elementi che il tuo sistema ha aggiunto al registro e aggiorna il tuo database di conseguenza in modo da poterli aggiornare in futuro, se necessario.
Leggi i record più velocemente
L'API v2.0, come l'API precedente, consente al tuo sistema di leggere una singola sezione o l'intero record in un'unica chiamata. Ciò che restituisce non saranno tutti i dati su un record, ma piuttosto una vista riassuntiva delle tre sezioni che tendono ad essere le più grandi su ORCID record: opere, finanziamenti e revisioni tra pari.
Sia che il tuo sistema legga l'intero record o una singola sezione, il vista di riepilogo di queste attività viene visualizzato. Il riepilogo contiene informazioni limitate: il riepilogo delle opere, ad esempio, restituisce solo il titolo dell'opera, il tipo, la data, i suoi identificatori univoci e la loro relazione con l'opera, l'indice di visualizzazione per ogni versione dell'articolo (se esistono più versioni), la sorgente (l'utente o il client API) e il codice put corrispondente per ogni versione dell'articolo.
Le viste di riepilogo riducono le dimensioni dei file e i tempi di trasferimento, riducendo il potenziale sforzo sul nostro sistema e sul tuo e velocizzando gli aggiornamenti.
E molto di più!
C'è molto di più nella v2.0 di cui essere felici: supporto flessibile per identificatori esterni, aggiunta di attività di revisione tra pari, raggruppamento più chiaro di più versioni di attività, risultati di ricerca migliori per impostazione predefinita e altro ancora.
Vuoi saperne di più? Unisciti a noi! Ogni mese teniamo webinar in più fusi orari e lingue e per il resto dell'anno discuteremo dell'aggiornamento all'API v2.0. Controlla i nostri elenchi per il prossimo, o CONTATTACI per saperne di più.
Hai già eseguito l'upgrade all'API v2.0? Facci sapere la tua esperienza!