Der Juli markiert den fünfter Monat seit unserer Veröffentlichung ORCID API v2.0, und wir freuen uns, Ihnen mitteilen zu können, dass viele Benutzer der öffentlichen und Mitglieder-API bereits ein Upgrade durchgeführt haben oder gerade dabei sind, dies zu tun. Um diejenigen unter Ihnen zu ermutigen, die noch nicht mit Ihrem Upgrade begonnen haben, möchten wir Folgendes hervorheben einige der v2.0-Funktionen Das vereinfacht Ihre Arbeitsabläufe, reduziert die Größe der Übertragungsdateien und vereinfacht Ihre ORCID Die Integration funktioniert sowohl für Sie als auch für Ihre Benutzer besser.
Weniger Bereiche, weniger Verwirrung
Unsere alte API ermöglichte es Ihnen, viele anzufordern Berechtigungen von Benutzern: Berechtigung, Elemente in einem Abschnitt zu erstellen, denselben Abschnitt zu lesen und zu aktualisieren. Das Anfordern separater Berechtigungen für jeden Abschnitt führte zu einer Liste von Anfragen, die die Benutzer verwirrten.
In API v2.0 haben wir haben unsere Tätigkeitsbereiche gefestigt in drei, mit denen Sie Lesezugriff (begrenzt) und Aktualisierungszugriff auf alle Abschnitte des anfordern können ORCID Rekord.
Haben Sie diese Token noch mit den älteren Berechtigungen? Keine Sorge – sie funktionieren weiterhin mit den Zugriffsebenen, für die sie ursprünglich ausgestellt wurden. Möglicherweise möchten Sie jedoch einen Workflow einbauen, um Benutzer aufzufordern, ihre Berechtigungen zu aktualisieren, wenn Ihr aktualisiertes System über neue Funktionen verfügt, die den Zugriff auf andere Abschnitte ihrer Datensätze umfassen.
Artikelweise lesen und aktualisieren
Wenn Ihr System bei Verwendung früherer Versionen der API ein neues einzelnes Werk zu einem Datensatz hinzufügen musste, zu dem Sie mehrere Werke hinzugefügt hatten, musste es den gesamten Werkabschnitt aktualisieren, einschließlich des neuen Werks und aller zuvor hinzugefügten Werke. Das Aktualisieren eines einzelnen Elements in einem Datensatz bedeutete daher, dass eine möglicherweise große Datei mit anderen Elementen gesendet wurde, die keine Änderungen aufwiesen, oder dass alle Elemente in diesem Abschnitt oder sogar der gesamte Datensatz verloren gingen.
v2.0 hat diesen Prozess vereinfacht Verwaltung von Artikeln auf individueller Basis. Ihr System kann ein einzelnes Werk zu einem hinzufügen ORCID Rekord, und bearbeiten oder löschen Sie dann dieses einzelne Werk. Dies geschieht durch die Implementierung Codes eingeben für einzelne Artikel auf der ORCID Registrierung. Wenn Ihr System beispielsweise eine neue Beschäftigungszugehörigkeit zu einem hinzufügt ORCID Rekord, die ORCID Die API gibt eine Bestätigungsnachricht zusammen mit dem Put-Code zurück, den Ihr System nur zum Aktualisieren oder Löschen dieses Elements verwenden kann. Im Allgemeinen kann jeweils nur ein Element hinzugefügt, bearbeitet oder gelöscht werden ORCID Rekord. Die einzige Ausnahme bilden Werke, die für viele Forscher den Großteil ihrer Arbeit ausmachen ORCID aufzeichnen. API v2.0 ermöglicht es Ihren Systemen bis zu 50 Werke lesen auf einmal, und zu Addieren Sie bis zu 100 Werke auf einmal. Das Bearbeiten oder Löschen von Werken muss weiterhin auf Artikelbasis erfolgen.
Put-Codes sind rückwirkend: Artikeln, die in 1.2 und früher hinzugefügt wurden, wurden alle Put-Codes zugewiesen. Denken Sie beim Aktualisieren Ihres Systems für Version 2.0 daran, ein Feld für den entsprechenden Put-Code hinzuzufügen. Sie können eine Abfrage durchführen ORCID Record, um die Put-Codes aller Elemente abzurufen, die Ihr System zur Registrierung hinzugefügt hat, und aktualisieren Sie Ihre Datenbank entsprechend, damit Sie sie in Zukunft bei Bedarf aktualisieren können.
Datensätze schneller lesen
API v2.0 ermöglicht Ihrem System wie die vorherige API dies Lesen Sie einen einzelnen Abschnitt oder den gesamten Datensatz in einem einzigen Aufruf. Was zurückgegeben wird, sind nicht alle Daten eines Datensatzes, sondern eine zusammenfassende Ansicht der drei Abschnitte, die in der Regel am umfangreichsten sind ORCID Aufzeichnungen: Arbeiten, Finanzierung und Peer-Reviews.
Unabhängig davon, ob Ihr System den gesamten Datensatz oder einen einzelnen Abschnitt liest, ist die zusammenfassende Ansicht dieser Aktivitäten wird angezeigt. Die Zusammenfassung enthält begrenzte Informationen: Die Werkzusammenfassung gibt beispielsweise nur den Werktitel, den Typ, das Datum, seine eindeutigen Identifikatoren und ihre Beziehung zum Werk, den Anzeigeindex für jede Version des Elements (falls mehrere Versionen vorhanden sind), die Quelle (den Benutzer oder API-Client) und den entsprechenden Put-Code für jede Version des Elements zurück.
Zusammenfassungsansichten reduzieren Dateigrößen und Übertragungszeiten, reduzieren die potenzielle Belastung für unser und Ihr System und machen Aktualisierungen schneller.
Und vieles mehr!
In Version 2.0 gibt es noch viel mehr, worüber man sich freuen kann: flexible Unterstützung für externe Identifikatoren, Hinzufügen von Peer-Review-Aktivitäten, klarere Gruppierung mehrerer Aktivitätsversionen, standardmäßig bessere Suchergebnisse und mehr.
Möchten Sie mehr erfahren? Begleiten Sie uns! Jeden Monat veranstalten wir Webinare in mehreren Zeitzonen und Sprachen und für den Rest des Jahres werden wir über ein Upgrade auf API v2.0 diskutieren. Schauen Sie sich unsere Angebote für das nächste an, oder kontaktieren Sie uns um mehr zu erfahren.
Haben Sie bereits ein Upgrade auf API v2.0 durchgeführt? Teilen Sie uns Ihre Erfahrungen mit!