Dieser Workflow erklärt, wie ORCID Mitglieder können Berechtigungen von den Forschern in einer Anwendung sammeln und die authentifizierten verwenden iD und Berechtigungen in anderen internen Anwendungen wo ORCID erforderlich.
Da Ihre Forscher Ihrer Organisation nur einmal die Erlaubnis erteilen müssen, spart der Forscher Zeit und kann die Nutzung und Verfügbarkeit von erhöhen ORCID iDs innerhalb Ihrer Organisation über mehrere Systeme hinweg.
Dieser Workflow eignet sich für Organisationen, die über mehrere Systeme verfügen ORCID ist im Lieferumfang enthalten und es stehen technische Ressourcen zur Verfügung, um eine benutzerdefinierte Integration mit dem zu erstellen ORCID API.
Beispiel-Workflow
Ein Beispiel für diesen Workflow könnte das Sammeln von IDs in Ihrem Identitätsmanagementsystem sein
- Der Benutzer wird von einem zentralen System (z. B. Identitätsmanagementsystem) aufgefordert, Ihrer Organisation die Erlaubnis zur Interaktion mit ihm zu erteilen ORCID iD
- Der Benutzer entscheidet sich, sich bei ihm anzumelden ORCID Aufnahme oder Registrierung für eine ORCID Rekord
- Der Benutzer erteilt Ihrer Organisation die Erlaubnis, mit ihm zu interagieren ORCID Datensatz (Teil des OAuth-Prozesses)
- Das zentrale System speichert die Benutzer ORCID iD und die Berechtigungen, die der Benutzer Ihrer Organisation gewährt hat
- Der ORCID iD und die Zugriffstoken können dann sicher auf jedes andere System übertragen werden, das Ihr Unternehmen erfassen muss ORCID IDs wie Ihr CRIS-System, HR oder ein institutionelles Repository.
- Verwendung der ORCID iD und Token können einzelne Systeme lesen/schreiben ORCID Aufzeichnungen. CRIS-Systeme können Zugehörigkeiten/Werke pushen, Repositories können Werke pushen usw
- Zeigen Sie die Authentifizierung an iD innerhalb Ihrer Systeme
Wir empfehlen Ihnen, in Ihrer Kommunikation und Ihrer eigenen Dokumentation den erwarteten Arbeitsablauf deutlich zu machen. Dadurch wird sichergestellt, dass Ihre Forscher über die Integration Ihrer Organisation informiert sind ORCID und was erwartet wird.
Mehr Infos
Als Ergebnis unserer Gespräche mit Verlagen, Anbietern und Forschern haben wir einen ersten Entwurf entwickelt Zusammenfassung des Datensatzes Prototyp. Wir hoffen, es den Redakteuren leichter zu machen, die darin enthaltenen Informationen zu finden und zu verstehen ORCID Aufzeichnungen und Oberfläche Vertrauensmarker Das kann Ihnen dabei helfen, Entscheidungen über die Vertrauenswürdigkeit eines zu treffen ORCID Rekord.
Welche Informationen werden in der Zusammenfassung angezeigt?
Abhängig davon, welche öffentlichen Daten innerhalb des Autors verfügbar sind ORCID Der Datensatz hängt davon ab, welche Informationen angezeigt werden. Nachfolgend finden Sie die Liste der Elemente, die angezeigt werden können:
- Name oder veröffentlichter/Kreditname – Wenn der Datensatz einen veröffentlichten Namen hat, wird dieser angezeigt, andernfalls wird der Name angezeigt
- ORCID iD
- Zugehörigkeiten – In diesem Abschnitt werden nur Beschäftigungselemente angezeigt. Name der Organisation mit einem Link zur Zugehörigkeits-URL (falls enthalten), Rolle, Daten (falls enthalten). Diese werden in chronologischer Reihenfolge vom neuesten zum ältesten angezeigt. Gegebenenfalls werden 3 Zugehörigkeiten angezeigt, zusammen mit einer zusätzlichen Anzahl weiterer Zugehörigkeiten im Datensatz.
- Werke – eine Anzahl validierter Werke und selbstbehaupteter Werke
- Peer-Review – eine Anzahl validierter Peer-Review-Elemente. Bitte beachten Sie, dass hier nur die Anzahl der validierten Elemente angezeigt wird, da Benutzer die Peer-Review nicht manuell zu ihren Datensätzen hinzufügen können
- Finanzierung – eine Anzahl validierter und selbst eingeforderter Finanzierungen
- Berufliche Aktivitäten – in diesem Abschnitt werden die letzten drei Mitgliedschafts-, Service-, eingeladenen Positionen- und Auszeichnungselemente angezeigt. Diese werden in chronologischer Reihenfolge vom Neuesten zum Ältesten angezeigt.
- Andere Identifikatoren – In diesem Abschnitt werden die anderen Identifikatoren angezeigt, die mit denen des Benutzers verknüpft wurden ORCID Ausweis. Zum Beispiel Scopus Author ID, ISNI oder ResearcherID
- Schlüsseldaten – Zu den Daten gehören das Datum, an dem der Datensatz erstellt wurde, und das Datum, an dem der Datensatz zuletzt aktualisiert wurde
Was ist der Unterschied zwischen den validierten und den selbstbehaupteten Elementen?
Das Quellensymbol, das neben den verschiedenen Elementen angezeigt wird, zeigt an, ob das Element von einem vertrauenswürdigen Autor zum Datensatz des Autors hinzugefügt wurde ORCID Mitgliedsorganisation oder vom Autor selbst
- Validiert – Von einem Vertrauenswürdigen hinzugefügt ORCID Mitgliedsorganisation
- Selbstbehauptet – Direkt vom Autor hinzugefügt
Warum werden außer den Eckdaten keine Informationen angezeigt?
Die individuelle Kontrolle ist ein Kernprinzip der ORCID Vertrauensprogramm. ORCID Datensatzinhaber kontrollieren, welche Informationen zu ihnen hinzugefügt und daraus gelöscht werden ORCID Aufzeichnung, mit feiner Kontrolle über die Sichtbarkeit der Informationen und Kontrolle darüber, welche vertrauenswürdigen Organisationen und vertrauenswürdigen Personen auf ihre Aufzeichnungen zugreifen können, um ihre Informationen zu lesen, zu schreiben oder zu aktualisieren.
Der ORCID iD ist immer öffentlich verfügbar, aber der Datensatzinhaber kann die Sichtbarkeitseinstellungen aller anderen Elemente in seinem Datensatz steuern. In der Zusammenfassung werden nur Elemente angezeigt, die die Sichtbarkeitseinstellung „Jeder“ haben, da diese in der öffentlichen Version des Benutzers angezeigt werden ORCID Rekord.
Warum zeigt der Datensatz an, dass er gesperrt, veraltet oder deaktiviert ist?
wenn ein ORCID Wenn der Datensatz einen der oben genannten Status hat, sind auf dem Datensatz keine öffentlichen Daten verfügbar ORCID Rekord.
- Gesperrt = Datensatz entspricht nicht unseren Nutzungsbedingungen
- Veraltet = Datensatz wurde in einen anderen überholt ORCID iD
- Deaktiviert = Datensatz wurde vom Benutzer deaktiviert
Durchsuchen Sie unsere API-Benutzergruppe Weitere Informationen zum Einrichten einer Integration mit der öffentlichen API finden Sie in den Themen. Um jedoch die Vorteile zu maximieren ORCID, wir empfehlen euch join ORCID als Organisationsmitglied, das Zugang zu zusätzlichen Funktionen bietet, persönliche Unterstützung durch unser Integrationsteam bietet und natürlich unsere Arbeit unterstützt.
Anmeldeinformationen für öffentliche Kunden werden Einzelpersonen und nicht Organisationen gewährt. Anmeldeinformationen können nicht von einer Person auf eine andere übertragen werden, sie können jedoch in API-Anmeldeinformationen für Mitglieder umgewandelt werden, wenn alle Parteien zustimmen und die Organisation ein aktives Mitglied ist ORCID.
Durch das Verschieben der Client-ID zur Member-API wird die Client-ID nicht geändert, sondern nur das Client-Geheimnis, und Sie behalten die Anzahl der verbundenen IDs mit Ihrer Nur-Lese-Berechtigung.
Bei der Konvertierung des Public API-Clients in einen Member API-Client wird der Nutzungsbedingungen für öffentliche Kunden gelten nicht mehr und werden durch die Bedingungen der Mitgliedsvereinbarung ersetzt.
Für die Überweisung benötigen wir:
- Bestätigung der zu konvertierenden Public API Client-ID.
- Dass der Hauptkontakt der Organisation und der Inhaber der aktuellen Public API-Client-ID mit der Änderung der Servicebedingungen einverstanden sind. (Der Inhaber muss ein Mitarbeiter, Auftragnehmer oder leitender Angestellter der Mitgliedsorganisation sein.) Wir protokollieren die Zustimmung beider Parteien.
- Ein Datum/eine Uhrzeit für die Migration. Im Rahmen dieser Migration aktualisieren wir die Client-ID und senden Ihnen ein neues Client-Geheimnis in einer verschlüsselten E-Mail. Bitte beachten Sie, dass Ihre Integration nach der Aktualisierung des Clients nicht funktioniert, bis Sie das Client-Geheimnis aktualisiert haben. Aus diesem Grund müssen wir ein Datum und eine Uhrzeit festlegen, damit dies durchgeführt wird, und um Unannehmlichkeiten für Benutzer zu vermeiden.
Damit die Konvertierung abgeschlossen werden kann, müssen Sie Folgendes aktualisieren:
- Das alte Client-Geheimnis zum neuen Client-Geheimnis.
- Der API-Host von pub.orcid.org zu api.orcid.org.
Mit Ihrer konvertierten Member API-Client-ID können Sie die hinzuzufügenden Bereiche aktualisieren Mitglieder-API-Bereiche. Dies erfordert eine Autorisierung durch die Benutzer und es werden neue Zugriffstoken generiert, um die neuen Bereiche/Berechtigungen einzuschließen.
Bitte beachten Sie, dass wir die Anmeldeinformationen von Mitglieds-API-Clients nicht in Anmeldeinformationen für die öffentliche API umwandeln können.
Konsortiumsmitglieder – Eine Liste Ihrer Konsortiumsmitglieder mit einer Zugehörigkeitsanzahl. Von dieser Liste aus können Sie einen Drillthrough zum Zugehörigkeitsbericht der einzelnen Mitglieder durchführen, um die Zugehörigkeitsdaten detaillierter anzuzeigen. Um einen Drill-Through durchzuführen, wählen Sie das Mitglied aus der Liste aus, klicken Sie mit der rechten Maustaste, wählen Sie Drill-Through und klicken Sie dann auf den entsprechenden Bericht.
IDs der Mitgliedsorganisationen des Konsortiums – Eine Liste der registrierten Organisations-IDs Ihrer Konsortiumsmitglieder, einschließlich des Identifikatortyps, -werts und -namens.
Dieser Beispielaufruf ruft eine Zusammenfassung des gesamten ab ORCID Datensatz im XML-Format mithilfe der Member-API auf dem Sandbox-Server. Sie benötigen ein Zugriffstoken, um API-Anfragen an die öffentliche oder Mitglieder-API zu stellen.
Method: GET
Accept: application/vnd.orcid+xml
Authorization type and Access token: Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
Die API gibt eine 200 OK-Nachricht zurück, die angibt, dass die Anfrage erfolgreich empfangen wurde, und die vollständige Zusammenfassung der Anfrage ORCID Aufzeichnung, einschließlich Zusammenfassungen einzelner Elemente
<?xml version="1.0" encoding-"UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789"
xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
Für jedes Element (Arbeit, Finanzierung, Beschäftigung usw.) gibt es eine Code eingeben. Dies kann bei Bedarf verwendet werden, um vollständige Details zum Artikel zu erhalten.
Wir empfehlen Ihnen, unsere zu lesen schriftliche Dokumentation. Wenn Sie noch Fragen haben und ein ORCID Mitglied, bitte kontaktiere den support; Nichtmitglieder können dem beitreten ORCID API-Benutzergruppe.
Sie können den Status sowohl unseres Produktionsservers als auch unseres Sandbox-Servers überprüfen, indem Sie Folgendes aufrufen:
Sandkasten
- https://pub.sandbox.orcid.org/{{version}}/pubStatus
- https://api.sandbox.orcid.org/{{version}}/apiStatus
Produktion
Sie können auch eine tägliche Übersicht unter http://status.orcid.org/ einsehen.
Der ORCID Der Datensatz ist in einzelne Abschnitte unterteilt, um das Lesen des Datensatzes schneller und konsistenter zu gestalten. Sie können zunächst einen Abschnitt aufrufen, um dessen Zusammenfassung zu erhalten, und dann mithilfe des Put-Codes eines einzelnen Elements aufrufen, um aussagekräftige Informationen zu diesem Element zu erhalten.
Nachfolgend finden Sie eine Tabelle mit den zusammenfassenden Abschnitten, die Sie mit der API lesen können.
Endpunkt | Beschreibung |
/Aufzeichnung | Zusammenfassende Ansicht des Vollständigen ORCID Rekord |
/Person | Biografischer Teil des ORCID Datensatz, auch über /researcher-urls unten |
/Zusammenfassung | Zusammenfassende Ansicht der validierten und selbstbehaupteten Elemente auf der ORCID Datensatz (nur mit der Member-API verfügbar) |
/Adresse | Die Länder oder Regionen des Forschers |
Die mit dem Datensatz verknüpften E-Mail-Adressen | |
/externe-Identifikatoren | Verknüpfte externe Identifikatoren in anderen Systemen |
/Schlüsselwörter | Schlüsselwörter im Zusammenhang mit dem Forscher und seiner Arbeit |
/andere Namen | Andere Namen, unter denen der Forscher bekannt ist |
/persönliche Daten | Persönliche Daten: Name des Forschers, (veröffentlichter) Kreditname und Biografie |
/researcher-urls | Links zu den persönlichen Seiten oder Profilseiten des Forschers |
/Aktivitäten | Zusammenfassung des Aktivitätenabschnitts des ORCID aufzeichnen, auch über /works unten. |
/Bildungen | Bildungszugehörigkeiten |
/Beschäftigungen | Beschäftigungszugehörigkeiten |
/Finanzierungen | Zusammenfassung der Förderaktivitäten |
/peer-reviews | Zusammenfassung der Peer-Review-Aktivitäten |
/funktioniert | Zusammenfassung der Forschungsarbeiten |
/ Forschungsressourcen | Zusammenfassung der Forschungsressourcen |
/Dienstleistungen | Zusammenfassung der Dienstleistungen |
/Qualifikationen | Zusammenfassung der Qualifikationen |
/Mitgliedschaften | Zusammenfassung der Mitgliedschaften |
/Unterscheidungen | Zusammenfassung der Unterscheidungen |
/eingeladene-positionen | Zusammenfassung der eingeladenen Stellen |
Zur Unterstützung der sozialen Komponente bieten wir ein Toolkit an Outreach-Ressourcen um Ihnen bei der Entwicklung einer Kampagne zur Unterstützung Ihrer Integration und der Kommunikation mit Ihren Forschern zu helfen:
- Was ORCID ist.
- Warum Ihr System IDs sammelt und wie Ihr System Aufgaben ausführt, z. B. die Aktualisierung ihrer Datensätze.
- Warum Ihre Forscher von der Erstellung einer ORCID iD und ihre IDs mit Ihrem System verbinden.
- Wie ORCID kommt der breiteren, globalen Forschungsgemeinschaft zugute.
Wir werden diese „Bibliothek“ an Ressourcen basierend auf dem Feedback der Community kontinuierlich erweitern. Wenn Sie eine Idee für etwas haben, das Ihnen gefallen könnte, können Sie sich gerne an uns wenden.
Dieser Beispielaufruf ruft eine Zusammenfassung des gesamten ab ORCID Datensatz im XML-Format mithilfe der Member-API auf dem Sandbox-Server. Sie benötigen ein Zugriffstoken, um API-Anfragen an die öffentliche oder Mitglieder-API zu stellen.
Method: GET Accept: application/vnd.orcid+xml
Authorization type and Access token:
Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
Die API gibt eine 200 OK-Nachricht zurück, die angibt, dass die Anfrage erfolgreich empfangen wurde, und die vollständige Zusammenfassung der Anfrage ORCID Aufzeichnung, einschließlich Zusammenfassungen einzelner Elemente.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
Für jedes Element (Arbeit, Finanzierung, Beschäftigung usw.) gibt es eine Code eingeben. Dies kann bei Bedarf verwendet werden, um vollständige Details zum Artikel zu erhalten.
Elemente (Arbeiten, Beschäftigung, Finanzierung, Peer-Review usw.) können zu einem hinzugefügt werden ORCID entweder manuell oder mit dem aufzeichnen ORCID Mitglieds-API. Wenn Sie eine Einzelperson sind und Ihre Akte aktualisieren möchten, schauen Sie sich unsere an Hilfebereich dazu finden Sie hier. Wenn Sie Mitglied sind und Elemente zu einem hinzufügen möchten ORCID Für die Aufnahme benötigen Sie Folgendes:
- Die Erlaubnis der Forscher
- Anmeldeinformationen für die Mitglieds-API
- Und entweder:
- Ein Anbietersystem, das sich in das integrieren lässt ORCID Mitglieder-API
- Ihr eigenes System, das sich in das integrieren lässt ORCID Mitglieder-API
Eine vollständige Anleitung für Mitglieder, die die API verwenden, um Elemente in einen Datensatz aufzunehmen, finden Sie in unserem API-Tutorial-Link unten:
Bevor Sie ein Element zum hinzufügen können ORCID Datensatz müssen Sie Ihre Daten formatieren ORCID Schema. Formatieren Sie Ihre Daten im ORCID Nachrichtenschema in XML oder JSON.
Unser GitHub-Repository enthält Ressourcen, die bei der Formatierung beim Erstellen neuer Elemente auf dem GitHub-Repository hilfreich sind ORCID aufzeichnen und beim Lesen vorhandener Elemente auf dem ORCID Aufzeichnung:
Beachten Sie, dass verschiedene Versionen der API unterschiedliche Nachrichtenformate haben. Schemata und Beispiele der Versionen 2.0 und 2.1 sind ebenfalls verfügbar.
Weitere Beispiele können leicht gefunden werden, indem man die Metadaten eines gut gefüllten Datensatzes liest.
Aktualisierungstoken werden verwendet, um zusätzliche Zugriffstoken zu generieren. Beim Austausch eines Autorisierungscodes im Rahmen des Zugriffstokens wird ein Aktualisierungstoken zurückgegeben dreistufige OAuth-Prozesseund kann verwendet werden, solange das Zugriffstoken aktiv bleibt.
Die neuen Zugriffstoken können denselben Ablauf und dieselben Gültigkeitsbereiche wie das ursprüngliche Zugriffstoken haben oder so festgelegt werden, dass sie eine kürzere Lebensdauer sowie eine kleinere Teilmenge von Gültigkeitsbereichen als das ursprüngliche Zugriffstoken haben. Neue Zugriffstoken können generiert werden, um den ursprünglichen Token zu ersetzen, oder als zusätzlicher Token generiert werden. Sie können Aktualisierungstokenaufrufe auch verwenden, um die ursprünglichen Zugriffs- und Aktualisierungstoken sowie alle vom Benutzer gewährten Berechtigungen vollständig ablaufen zu lassen.
Wir empfehlen die Verwendung von Aktualisierungstokens unter den folgenden Bedingungen:
- Ersetzen von Zugriffstokens, die möglicherweise kompromittiert wurden (Stellen Sie sicher, dass Sie anschließend das ursprüngliche Zugriffstoken widerrufen)
- Geben Sie einem Dritten, der ebenfalls Teil Ihres ist ORCID Integration eingeschränkterer Zugang und/oder Zugang für eine begrenzte Zeit.
Entnehmen Sie bitte unserem Technische Dokumentation Informationen zum Erstellen neuer Zugriffstokens aus Aktualisierungstokens.
Frühere Version des ORCID Die API hatte zusätzliche Bereiche. Diese Bereiche wurden mit der 2.0-API schrittweise eingestellt. Wir empfehlen, bei allen Integrationen nur die empfohlenen Bereiche zu verwenden. Als Referenz sind unten die früheren Bereiche aufgeführt, wobei stattdessen der aktuelle Bereich verwendet werden sollte
- /orcid-profile/lesen-begrenzt stattdessen verwenden /read-limited
- /orcid-works/lesen-begrenzt stattdessen verwenden /read-limited
- /orcid-bio/leselimitIch würde stattdessen verwenden /read-limited
- /orcid-works/erstellen stattdessen verwenden /Aktivitäten/Update
- /orcid-works/update stattdessen verwenden /Aktivitäten/Update
- /zugehörigkeiten/erstellen stattdessen verwenden /Aktivitäten/Update
- /zugehörigkeiten/update stattdessen verwenden /Aktivitäten/Update
- /Finanzierung/Erstellen stattdessen verwenden /Aktivitäten/Update
- /funding/update verwenden Sie stattdessen /activities/update
- /orcid-bio/update stattdessen verwenden /person/update
- /orcid-bio/externe-kennungen/erstellen stattdessen verwenden /person/update
Es gibt zwei unterschiedliche Aktualisierungsbereiche – einen für biografische Details und einen für Aktivitäten.
Geltungsbereich | Beschreibung | API-Endpunkte |
/person/update | Biografische Daten – die linke Spalte des ORCID Benutzeroberfläche aufzeichnen. | /Adresse /externe-Identifikatoren /Schlüsselwörter /andere Namen /researcher-urls |
/Aktivitäten/Update | Forschungsaktivitätsdaten – die rechte Spalte des ORCID Benutzeroberfläche aufzeichnen. | /Unterscheidung /Unterscheidungen /Bildung /Bildungen /Anstellung /Beschäftigungen /Finanzierung /Finanzierungen /eingeladene-position /eingeladene-positionen /Mitgliedschaft /Mitgliedschaften /peer-review /peer-reviews /Qualifikation /Qualifikationen / Forschungsressource / Forschungsressourcen /Bedienung /Dienstleistungen /Arbeit /funktioniert |
Verwenden Sie Ihre Client-ID, Ihr Geheimnis und entweder das aktive Token oder das zugehörige Aktualisierungstoken, um das Tokenpaar zu widerrufen. Sie können Token-Paare widerrufen, die sowohl im Two-Legged- als auch im Two-Legged-Modus erstellt wurden dreistufige OAuth-Prozesse. Wenn Sie über mehrere Token-Sets verfügen, z. B. für unterschiedliche Bereiche, werden nur das angegebene Zugriffstoken und das entsprechende Aktualisierungstoken widerrufen.
Wir empfehlen, Token unter den folgenden Bedingungen zu widerrufen:
- Um nach Beendigung einer Beziehung an einen Drittanbieter ausgegebene Token zu widerrufen;
- Um Token zu widerrufen, wenn Benutzer ihre Verbindung trennen ORCID iD von Ihrem System;
- Damit Benutzer Token aus Ihrem System heraus widerrufen können.
Wir empfehlen die Verwendung der Token aktualisieren um den Umfang oder die Dauer eines vorhandenen Zugriffstokens zu begrenzen oder ein Token zu aktualisieren, wenn es kompromittiert wurde.
Der Widerruf-API-Aufruf
https://sandbox.orcid.org/oauth/revoke (or https://orcid.org/oauth/revoke)
METHOD: POST
HEADER: accept:application/json
CONTENT-TYPE: application/x-www-form-urlencoded
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
token=[access token or refresh token for token pair to be revoked]
Alle Artikel (außer dem Biografietext) auf einem ORCID Rekord haben eine Code eingeben:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0"> [...]
</record:record>
Mit diesem Put-Code kann die API aufgerufen werden, um die vollständigen Daten für einen Artikel abzurufen. Die folgenden Elemente können mit a abgefragt werden Code eingeben:
Endpunkt | Beschreibung |
/address/[Code eingeben] | Ein einzelnes Land oder eine einzelne Region |
/Biografie | Das Biografiefeld: ein freier Textbereich, der nur vom Forscher bearbeitet werden kann |
/education/[Code eingeben] | Ein individuelles Bildungszugehörigkeitselement |
/email/[Code eingeben] | Eine individuelle E-Mail-Adresse, die dem Datensatz zugeordnet ist |
/employment/[Code eingeben] | Ein individuelles Beschäftigungszugehörigkeitselement |
/external-identifier/[Code eingeben] | Eine einzelne verknüpfte externe Kennung in einem anderen System |
/funding/[Put-Code] | Eine individuelle Fördermaßnahme |
/keywords/[Code eingeben] | Ein individuelles Schlüsselwort, das sich auf den Forscher und seine Arbeit bezieht |
/andere-namen/[Code eingeben] | Ein individueller Zusatzname, unter dem der Forscher bekannt ist |
/peer-review/[Code eingeben] | Eine individuelle Peer-Review-Aktivität |
/researcher-urls/[Code eingeben] | Ein individueller externer Link zur persönlichen Seite oder Profilseite des Forschers |
/work/[Code eingeben] | Eine individuelle Forschungsarbeit |
/works/[Put-Code1],[Put-Code2],[Put-Code3] | Einzelne Forschungsarbeiten in großen Mengen (bis zu 100) |
Mithilfe des Abschnittsendpunkts und des Put-Codes können Sie die API mit demselben Zugriffstoken aufrufen, um dieses bestimmte Element vollständig abzurufen. Dieser Beispielaufruf ruft den vollständigen Finanzierungsartikel 4413 im XML-Format mithilfe der Mitglieds-API auf dem Sandbox-Server ab.
Method: GET Accept: application/vnd.orcid+xml Authorization type and Access token: Bearer [stored access token]URI: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/funding/4413
Die API gibt eine 200 OK-Nachricht zurück, um anzugeben, dass die Nachricht erfolgreich empfangen wurde, und gibt den vollständigen XML-Code des Finanzierungselements zurück:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<funding:funding put-code="4413" path="/0000-0002-9227-8514/funding/4413" visibility="public" [...] >
[...]
</funding:funding>
Sie können das überprüfen Quelle eines Artikels wenn Sie es lesen möchten, wenn Sie wissen möchten, wer es hinzugefügt hat.
ORCID Mitglieder können Informationen aktualisieren, die sie zuvor zu einem hinzugefügt haben ORCID aufzeichnen. Es kann jeweils nur ein Element aktualisiert werden, und zwar nur mit den Client-Anmeldeinformationen, mit denen es ursprünglich erstellt wurde.
Um die Aktualisierung zu erleichtern, stellen Sie sicher, dass Sie Speichern Sie den Put-Code und das Zugriffstoken beim Erstellen von Artikeln.
Formatieren Sie das aktualisierte Element in ORCID Nachrichtenschema mit den geänderten Informationen und schließen die gespeicherten ein Code eingeben.
<?xml version="1.0" encoding="UTF-8"?> <employment:employment put-code="739288" [...]> [...] </employment:employment>
Rufen Sie die API auf:
Method: PUT Content-type: application/vnd.orcid+xml or application/vnd.orcid+jsonnAuthorization type and Access token: Bearer [stored access token]Data: link to file or text of affiliation to update URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
Die API gibt eine 200 OK-Meldung zurück, um anzuzeigen, dass das Element korrekt aktualisiert wurde. Schauen Sie auf unserer Fehlerbehebungsseite nach, wenn eine andere Meldung zurückgegeben wird.
Eine Liste häufiger API-Fehlercodes, ihre möglichen Bedeutungen und Tipps zur Fehlerbehebung finden Sie in unserem Technische Dokumentation.
Wenn Sie das aufgetretene Problem nicht lösen können, teilen Sie uns dies bitte mit.
Die Sichtbarkeit gibt die Datenschutzeinstellung des Elements an, basierend auf der vom Benutzer festgelegten Sichtbarkeitseinstellung. Wenn bei der Veröffentlichung von Informationen über die API ein Sichtbarkeits-Tag enthalten ist, wird es ignoriert. Vielmehr werden die Informationen gemäß der standardmäßigen Sichtbarkeitseinstellung des Benutzers veröffentlicht, die in seinen Kontoeinstellungen festgelegt ist.
Öffentliche Elemente können von jedem über die API gelesen werden und werden im öffentlichen Datensatz des Forschers angezeigt. Elemente vertrauenswürdiger Parteien werden nur über die API an Clients zurückgegeben, die über eingeschränkten Lesezugriff verfügen. sie sind nicht in den öffentlichen Aufzeichnungen des Forschers enthalten. Private Elemente sind nur für den Forscher und die Quelle des Elements sichtbar – die einzigen privaten Elemente, die über die API zurückgegeben werden, sind diejenigen, die über Ihre Integration zum Datensatz hinzugefügt wurden Weitere Informationen zu Sichtbarkeitseinstellungen finden Sie im ORCID Registratur.
Elemente (Arbeiten, Beschäftigung, Finanzierung, Peer-Review usw.) können zu einem hinzugefügt werden ORCID Aufnahme mit dem ORCID Mitglieds-API. Dazu müssen Sie zunächst Holen Sie mithilfe von OAuth die Erlaubnis des Forschers ein und dem Formatieren Sie die Elementmetadaten Verwendung der ORCID Nachrichtenschema.
Sobald Sie die Daten formatiert und gesammelt haben ORCID iD und Zugriffstoken erstellen Sie eine API-Anfrage mit HTTP POST und geben dabei an relevanten Endpunkt.
Method: POST
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]data: link to file or text of single employment item to add
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment
Der folgende Aufruf fügt eine neue hinzu Beschäftigung Zugehörigkeit zu einem Datensatz auf dem Sandbox-Testserver:
<?xml version="1.0" encoding="UTF-8"?>
<employment:employment [...]>
[...]
</employment:employment>
Die API gibt eine 201-Nachricht zurück, um anzuzeigen, dass der Artikel zusammen mit dem Artikel korrekt gepostet wurde Code eingeben. Ihr Kunde wird als aufgeführt Quelle des Artikels.
Schauen Sie sich unsere Fehlersuche Seite, wenn eine andere Nachricht zurückgegeben wird. Sie müssen das speichern Speichern Sie den Put-Code und das Zugriffstoken um Aktualisierungen vorzunehmen oder das Element zu entfernen.
Der ORCID Die Such-API verwendet die SOLR-Syntax. Alle in SOLR 3.6 verfügbaren Abfragesyntaxen werden unterstützt, einschließlich Lucene mit Solr-Erweiterungen (Default), DisMax und Extended Dismax.
Zur Nutzung benötigen Sie ein „/read-public“-Zugriffstoken. Sobald Sie Ihr Suchtoken erhalten haben, erstellen Sie Ihre Basissuch-URL:
Art der Anmeldeinformationen: | Öffentliche API | Mitglieder-API |
Ressourcen-URL: | Sandbox: https://pub.sandbox.orcid.org Produktion: https://pub.orcid.org | Sandbox: https://api.sandbox.orcid.org Produktion: https://api.orcid.org |
API-Version: | v3.0 | |
Endpunkt suchen | /search/?=[Abfrage] |
Ein Beispielaufruf zur Suche nach „orcid“ mit dem Token in der öffentlichen Sandbox-API mit den im XML-Format zurückgegebenen Ergebnissen lautet:
Method: GET Content-type: application/vnd.orcid+xmlnAuthorization type and Access token: Bearer [stored access token]URL: https://pub.sandbox.orcid.org/v3.0/search/?q=orcid
Die Ergebnisse geben die Anzahl der gefundenen Ergebnisse an (num-found) und zeigen standardmäßig die ersten 1000 Ergebnisse an:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<search:search num-found="385" xmlns:search="https://www.orcid.org/ns/search" xmlns:common="https://www.orcid.org/ns/common">
<search:result>
<common:orcid-identifier>
<common:uri>https://sandbox.orcid.org/0000-0001-2345-6789</common:uri>
<common:path>/0000-0001-2345-6789</common:path>
<common:host>sandbox.orcid.org</common:host>
</common:orcid-identifier>
</search:result>
[...]
</search:search>
Ein Beispiel für eine einfache Suche in der öffentlichen Sandbox-API mit Ergebnissen, die im JSON-Format zurückgegeben werden:
Method: GET
Content-type: application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.sandbox.orcid.org/v3.0/search/?q=newman
Die Suche gibt nur die Einzelperson zurück ORCID IDs von Datensätzen mit öffentlichen Daten, die mit der Suche übereinstimmen. Um weitere Informationen über das Ergebnis zu erhalten, rufen Sie an, um die zu lesen ORCID direkt aufnehmen.
Weitere Informationen finden Sie auf unserer Tutorial zur Such-API.
Wenn Sie Daten hinzugefügt haben, die gelöscht werden müssen, z. B. wenn diese mit einem Unrecht verknüpft wurden ORCID iD, dann können Sie eine HTTP-DELETE-Anfrage unter Angabe der stellen relevanten Endpunkt, zusammen mit ORCID Ich würde, gespeicherter Zugriffstoken und gespeicherter Put-Code. Es kann jeweils nur ein Element gelöscht werden, und Sie können nur von Ihrem Kunden hinzugefügte Elemente löschen. Sie können Elemente auch dann löschen, wenn der Benutzer die Berechtigung widerrufen hat.
Dieser Beispielaufruf löscht das Beschäftigungselement mit dem Put-Code „739288“ aus einem Datensatz.
Method: DELETE
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
In realen Situationen werden API-Interaktionen von Ihrem System mithilfe einer Programmiersprache wie PHP, Java oder Ruby on Rails durchgeführt. Zum Üben und Testen können Sie mit dem interagieren ORCID APIs, die eine Reihe von Tools verwenden, die HTTP-Anfragen stellen und empfangen können. Die meisten Desktop-HTTP-Tools werden in der Befehlszeile ausgeführt. Für diejenigen, die eine grafische Oberfläche bevorzugen, sind webbasierte Tools eine sinnvolle Alternative.
XML/XSD-VERIFIZIERUNG
Es gibt viele Tools, die Ihr XML für Sie überprüfen. Es ist eine gute Idee, eines zu adoptieren. Bei vielen API-Aufrufen arbeiten Sie mit XML-formatierten Informationen. Besonders bei der Arbeit mit ORCID Bei der API-Nachricht ist es wichtig, dass das von Ihnen verwendete XML gegenüber der XSD gültig ist. (Siehe unsere Dokumentation auf GitHub für die ORCID Nachrichtenschema XSD.)
ORCID SANDBOX-TESTSERVER
Der Sandbox-Testserver ist eine Kopie von ORCID Registrierungssoftware und enthält nur Testdaten. Es soll einen Ort bieten, an dem man Dinge ausprobieren kann, ohne die Realität zu beeinträchtigen ORCID iDs, insbesondere wenn Sie mit dem arbeiten ORCID API und benötigen einen Ort zum Testen Ihrer Arbeit. Sie können Benutzerkonten erstellen und API-Aufrufe in der Sandbox testen, ohne sich Sorgen machen zu müssen, dass Produktionsdaten beeinträchtigt werden oder Forscher versehentlich Spam erhalten.
Sie müssen nicht einmal ein sein ORCID Mitglied, um die Mitglieds-API in der Sandbox auszuprobieren. Alle sind herzlich eingeladen, Anmeldeinformationen für die Sandbox-Mitglieds-API anzufordern und alle für die Mitglieds-API verfügbaren Funktionen auszuprobieren.
Die Site und die APIs werden nicht so zuverlässig sein wie bei den Produktionsservern. Wir geben keine Garantien für die Daten in der Sandbox. Sie werden nicht gesichert und können gelöscht werden. Die Sandbox enthält möglicherweise auch einige experimentelle Funktionen, die noch nicht auf den Produktionsservern vorhanden sind, sodass Sie Dinge ausprobieren können, bevor sie in der Registrierung vorhanden sind. Mehr erfahren über den Sandbox-Testserver bzw Kundenanmeldeinformationen anfordern.
HTTP-TOOLS
Es stehen viele Tools zum Ausführen von HTTP-Anfragen zur Verfügung. Einige verwenden wir:
Der ORCID Die Such-API verwendet die SOLR-Syntax. Alle in SOLR 3.6 verfügbaren Abfragesyntaxen werden unterstützt, einschließlich Lucene mit Solr-Erweiterungen (Default), DisMax und Extended Dismax.
Sie können eine Feldsuche verwenden, wenn Sie einen bestimmten Abschnitt des durchsuchen müssen ORCID aufzeichnen. Die aktuelle Liste der in der API-Suche erkannten Felder zusammen mit den entsprechenden Datensatzstrukturelementen lautet wie folgt:
Suchfeld | Beschreibung |
Biografische Daten | |
Vornamen | Der oder die Vornamen des Benutzers. |
Nachname | Der Familienname (Nachname) des Benutzers. |
Kreditname | Der „veröffentlichte Name“ auf der ORCID Benutzeroberfläche, der Name, der normalerweise in Veröffentlichungen des Benutzers erscheint |
andere Namen | Alternative Namen, die möglicherweise in Veröffentlichungen des Benutzers aufgetaucht sind. |
Die E-Mail-Adresse des Benutzers. | |
Stichwort | Alle mit dem Benutzer verknüpften Schlüsselwörter. |
externe-id-referenz | Den Benutzern hinzugefügte Kennungen aus anderen Systemen ORCID Aufzeichnung über die API. |
Zugehörigkeitsdaten | |
Name der Zugehörigkeitsorganisation | Der Name einer beliebigen Organisation in einem Bildungs- oder Beschäftigungselement im Datensatz des Benutzers. |
Grid-org-id | Der GRID-ID einer Organisation im Abschnitt „Aktivitäten“ des Benutzerdatensatzes. Im Allgemeinen ist dies mit einer Ausbildung oder Beschäftigung verbunden. |
ror-org-id | Der ROR-ID einer Organisation im Abschnitt „Aktivitäten“ des Benutzerdatensatzes. Im Allgemeinen ist dies mit einer Ausbildung oder Beschäftigung verbunden. |
ringgold-org-id | Der Ringgold-ID* einer beliebigen Organisation im Abschnitt „Aktivitäten“ des Benutzerdatensatzes. Im Allgemeinen ist dies mit einer Ausbildung oder Beschäftigung verbunden. |
Finanzierungsdaten | |
Fördertitel | Der Titel eines beliebigen Finanzierungselements im Benutzerdatensatz. |
fundref-org-id | Der Crossref-Förderer-Registrierungs-ID einer Organisation im Abschnitt „Aktivitäten“ eines Benutzerdatensatzes. Im Allgemeinen ist dies mit einem Finanzierungsposten verknüpft, kann aber auch mit einer Zugehörigkeit verknüpft sein. |
Fördernummern | Fördernummer (Kennung) eines beliebigen Finanzierungselements im Datensatz des Benutzers. |
Daten zu Forschungsaktivitäten | |
Werktitel | Die Titel aller Werke im Datensatz des Benutzers. |
digitale-objekt-ids | Eine externe Arbeitskennung vom Typ doi |
doi-selbst | Ein externer Arbeitsbezeichner mit dem Typ „doi“ und der externen Bezeichnerbeziehung, die auf „self“ festgelegt ist |
[Typ der externen Kennung]* | Ein externer Arbeitsbezeichner mit dem angegebenen Typ |
[externer Bezeichnertyp]*-self | Ein externer Arbeitsbezeichner mit dem angegebenen Typ und der auf self gesetzten externen Bezeichnerbeziehung |
[externer Bezeichnertyp]*-Teil von | Ein externer Arbeitsbezeichner mit dem angegebenen Typ und der externen Bezeichnerbeziehung, die auf Teil von festgelegt ist |
[Typ der externen Kennung]*-Version-von | Ein externer Arbeitsbezeichner mit dem angegebenen Typ und der externen Bezeichnerbeziehung, die auf „Version von“ festgelegt ist * Eine vollständige Liste der externen Identifikatoren finden Sie im Liste der Bezeichner. Einige Bezeichner erfordern möglicherweise „-self“, „-part-of“ oder „-version-of“, um Ergebnisse zurückzugeben |
ORCID Daten aufzeichnen | |
orcid | Die 16-stellige ORCID Kennung des Benutzers im Format 0000-0001-2345-6789. |
Profil-Einreichungsdatum | Das Datum und die Uhrzeit, zu der der Datensatz erstellt wurde. |
Datum der letzten Änderung des Profils | Datum und Uhrzeit der letzten Änderung des Datensatzes. |
Alle Daten | |
Text | Alle oben genannten Felder. Dies ist auch das Standardfeld für Lucene-Syntaxabfragen. |
Sie finden weitere Information unter den jeweiligen Such-API-Tutorial um mehr zu erfahren.
*Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ für weitere Infos
Die URL zum Aufheben der Registrierung eines Webhooks ist dieselbe wie für die Registrierung. Sie müssen jedoch die HTTP-DELETE-Methode verwenden.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
HEADER: Authorization: Bearer [Your access token]
HEADER: Content-Length: 0
METHOD: DELETE
Die Antwort sollte sein 204 No Content
.
HTTP/1.1 204 No Content
Server: Apache-Coyote/1.1
Date: Fri, 05 Apr 2013 12:49:17 GMT
Webhooks können von Premium-Mitgliedern gegen jeden registriert werden ORCID im Register eintragen. Die Schritte sind:
Verschlüsseln Sie die URL
URL-kodieren Sie die gewünschte URL ORCID Wird aufgerufen, wenn der Benutzerdatensatz aktualisiert wird. Zum Beispiel die folgende URL:
https://nowhere2.com/0000-0002-7465-2162/updated
wird
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Erstellen Sie die URL
Erstellen Sie die vollständige URL für ORCID API-Aufruf beginnend mit der URL des ORCID Datensatz und fügen Sie dann ‚√∫/webhook√√π und die URL hinzu, die Sie aufrufen möchten. Es sollte also wie folgt aussehen: https://api.sandbox.orcid.org/{ORCID}/webhook/{URL-ENCODED-WEBHOOK-URL}
Verwenden Sie beispielsweise die obige Webhook-URL und die ORCID iD 0000-0002-7465-2162, die vollständige URL lautet:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
Registrieren Sie den Webhook
Verwenden Sie das Zugriffstoken Ihres Webhooks, um Ihren Webhook beim Benutzer zu registrieren ORCID aufzeichnen. Sie müssen eine HTTP-PUT-Anfrage verwenden, sollten jedoch nichts in den Hauptteil der Anfrage einfügen.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdatedn HEADER: Accept: application/json HEADER: Authorization: Bearer [Your access token]n HEADER: Content-Length: 0n METHOD: PUT
Die Antwort sollte 201 sein. Wenn der Rückruf jedoch bereits vorhanden war, lautet die Antwort 204.
HTTP/1.1 201nServer: nginx/1.1.19nConnection: keep-alive Location: https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Frequestb.in%2Fz57lzcz5
Der ORCID Die Registrierung führt den folgenden HTTP-Aufruf aus, wenn ein Datensatz aktualisiert wird. Die Anfrage verwendet die HTTP-POST-Methode, aber der Hauptteil der Anfrage ist leer.
curl -v -X POST https://nowhere2.com/0000-0002-7253-3645/updated
Ihr Server sollte mit Standard-HTTP-Antwortcodes antworten. Wenn der Anruf erfolgreich war, sollten Sie also 204 No Content zurückgeben.
HTTP/1.1 204 No Content
Jeder 2xx-Antwortcode bedeutet, dass der Anruf erfolgreich war. Wenn Sie einen Code zurücksenden, der kein 2xx ist, werden wir den Anruf fünf Minuten später erneut versuchen.
Der ORCID Registry unterstützt „Content Negotiation“. Dies bedeutet, dass Maschinen und andere Systeme nachfragen können ORCID Register für Personenmetadaten in verschiedenen Formaten.
Eines dieser Formate ist JSON-LD, das das verwendet schema.org Vokabular, insbesondere der Personentyp, die wir mit Werken, Organisationen und anderen Identifikatoren verknüpfen. Wir unterstützen auch XML, JSON, RDF XML und Turtle und haben Cross-Origin Resource Sharing (CORS) implementiert, um den Zugriff auf unsere Daten zu erleichtern.
- Siehe Blogbeitrag für einen Überblick über ORCID und schema.org
- Sie finden weitere Information unter den jeweiligen Technische Dokumentation zur Inhaltsverhandlung
In realen Situationen werden API-Interaktionen von Ihrem System mithilfe einer Programmiersprache wie PHP, Java oder Ruby on Rails durchgeführt. Zum Üben und Testen können Sie jedoch mit dem interagieren ORCID API, die eine Reihe von Tools verwendet, die HTTP-Anfragen stellen und empfangen können. Die meisten Desktop-HTTP-Tools (z. B cURL) werden in der Befehlszeile ausgeführt; Für diejenigen, die eine grafische Oberfläche bevorzugen, sind webbasierte Tools eine sinnvolle Alternative.
Ein beliebtes Tool ist Googles OAuth 2.0 Playground, ein kostenloses, webbasiertes Tool, das von Google entwickelt und verwaltet wird.
Bitte sehen Sie sich unser praktisches API-Tutorial an unter: https://info.orcid.org/hands-on-with-the-orcid-api/
Hinweis: ORCID pflegt den OAuth 2.0 Playground nicht – dieses Tool wurde von Google erstellt, das ausschließlich seinen Code pflegt. Obwohl wir diese Dokumentation regelmäßig aktualisieren, kann es von Zeit zu Zeit zu Ungenauigkeiten kommen, da uns Änderungen am OAuth 2.0 Playground möglicherweise nicht sofort bekannt sind.
Die Kontrolle der Forscher ist ein Kernstück ORCID Prinzip Also E-Mail-Adressen registriert und dem hinzugefügt ORCID Datensatz sind standardmäßig so eingestellt, dass sie nur für den Datensatzinhaber sichtbar sind. Nicht verifizierte E-Mails werden nicht in der öffentlichen Ansicht des Datensatzes angezeigt und nur verifizierte E-Mail-Adressen werden in den API-Ergebnissen angezeigt.
Sobald Forscher ihre E-Mail-Adresse verifiziert haben, müssen sie entscheiden, ob sie diese für jedermann sichtbar (z. B. öffentlich) oder für vertrauenswürdige Parteien (z. B. eingeschränkter Zugriff) machen soll, damit die E-Mail-Adresse von Drittorganisationen gelesen werden kann.
Wenn der Forscher seine E-Mail-Adresse auf „Vertrauenswürdige Parteien“ eingestellt hat, wird diese mit der Aufzeichnung zurückgegeben, sofern der Forscher Ihnen die Erlaubnis erteilt hat lesebeschränkter Zugriff. Weitere Informationen finden Sie unter ORCID Sichtbarkeitseinstellungen.
Für unsere API-Version 2.0 und höher gelten folgende Grenzwerte:
- Fordern Sie eine Sekunde an – 24
- Burst – 40
Eine Sekunde anfordern – Anzahl der Anfragen, die pro Sekunde gestellt werden können.
Burst – Anzahl der Anfragen, die in die Warteschlange gestellt werden, bevor sie abgelehnt werden. Anfragen in der Warteschlange werden auf die Anzahl der Anfragen pro Sekunde verlangsamt. Wenn Sie den Burst überschreiten, erhalten Sie eine 503-Antwort.
Wenn Sie Probleme mit den Grenzwerten haben, wenden Sie sich bitte an Ihren Engagement-Teamleiter, um Unterstützung zu erhalten.
Bitte beachten Sie die ORCID Seite „Anbieterfähige Systeme“ für Verlage für die aktuellsten Informationen
API 3.0 ist die Standard-API-Version und wir empfehlen, diese Version beim Erstellen neuer Integrationen zu verwenden. Wir werden API 2.0 und 2.1 auf absehbare Zeit weiterhin unterstützen und die Abschaltung dieser Versionen mindestens 12 Monate im Voraus benachrichtigen.
Wir haben beim Übergang von API 1.2 zu API 2 viel gelernt. Dieses Mal haben wir die Verwaltung des Upgrades erheblich vereinfacht. API 3.0 fügt neue Funktionen hinzu und ändert bestehende Funktionen nur, wenn dies unbedingt erforderlich ist. Das bedeutet, dass Integratoren mit minimalem Aufwand auf die neue API umsteigen können sollten. Das bedeutet auch, dass wir Ihnen zwar empfehlen, so bald wie möglich mit der Planung Ihres Upgrades zu beginnen, damit Ihre Organisation und Ihre Forscher von den neuen Funktionen profitieren können, Sie jedoch viel Flexibilität bei der Entscheidung haben, wann Sie auf 3.0 aktualisieren.
Die kleine Liste potenziell bahnbrechender Änderungen finden Sie in unseren API-Versionshinweisen Hier und dem Hier . Es gibt einige Änderungen an optionalen/obligatorischen Feldern, JSON-Aufzählungen wurden leicht geändert und wir haben auch eine kleine Umgestaltung unserer XML-Schemas vorgenommen und einige neue Felder hinzugefügt, um die für die neue Funktionalität erforderlichen Metadaten zu enthalten.
Ja das tun wir! Mehr über unsere API-Versionierung, die dahinter stehenden Gründe und vieles mehr können Sie hier bei uns lesen API-Versionsrichtlinie.
Jedes Premium-Mitglied kann ein „/webhook“-Zugriffstoken erhalten. Mit einem einzigen Token können Webhooks für mehrere Datensätze registriert werden. Um einen Token zu erhalten, rufen Sie an ORCID API-Token-Endpunkt.
Dieser Prozess wird oft als OAuth-Ablauf für Client-Anmeldeinformationen oder 2-stufiges OAuth bezeichnet.
Unten finden Sie einen Beispielaufruf zum Abrufen des Zugriffstokens. Ersetzen Sie die Platzhalter durch Ihre Anmeldeinformationen (entfernen Sie unbedingt die Klammern).
curl -i -L -H "Accept: application/json"
-d "client_id=(your client ID)"
-d "client_secret=(your client secret)"
-d "scope=/webhook"
-d "grant_type=client_credentials"
"https://sandbox.orcid.org/oauth/token"
Sie erhalten dann ein Zugriffstoken ähnlich dem folgenden zurück.
{"access_token":"5eb23750-1e19-47a3-b6f6-26635c34e8ee",
"token_type":"bearer",
"refresh_token":"c7d3d5fd-e4c0-4825-89f2-7cfb4a1cf01e",
"expires_in":631138518,
"scope":"/webhook"}
In diesem Abschnitt wird angezeigt, wie viele Authentifizierungen Ihre Integrationen verarbeiten
Monatliche eindeutige OAuth-Benutzer
Anzahl der Benutzer, die über OAuth eine Verbindung zu Ihren Integration(en) hergestellt haben. Beachten Sie, dass es sich bei diesen Daten um Stichproben handelt, was bedeutet, dass die angegebenen Zahlen durch Extrapolation aus einer Teilmenge der Benutzeraktivität geschätzt werden.
In diesem Abschnitt wird angezeigt, wie viele ORCID Datensätze sind mit Ihrer(n) E-Mail-Domain(s) verbunden
IDs mit E-Mail-Domain(s):
Eine Metrik, die die Gesamtzahl der iDs zählt, deren E-Mail-Adresse auf eine der registrierten Domänen endet. Wenn Sie möchten, dass weitere Domains hinzugefügt werden, teilen Sie uns dies bitte mit.
E-Mails mit Domain(s) im Laufe der Zeit:
Eine Grafik, die die Nutzung registrierter Domains im Zeitverlauf zeigt. Forscher haben möglicherweise mehr als eine E-Mail-Adresse registriert und in dieser Grafik werden alle Adressen des Forschers gezählt.
Domainverteilung:
Ein Diagramm, das die Aufschlüsselung der E-Mail-Domänen zeigt, die den registrierten Domänen entsprechen. Wenn beispielsweise example.com registriert ist, wird die Aufteilung zwischen „apple.example.com“ und „banana.example.com“ angezeigt.
Bitte beachten Sie, dass E-Mail-Domänen keine zuverlässige Datenquelle für die Anzahl der Forscher in Ihrer Organisation sind. Viele Forscher nutzen generische Webmail-Dienste.
Während wir unsere Produkte weiterentwickeln, gibt es eine Reihe von Funktionen, die nur mit API 3.0 verfügbar sind, unserer neuesten und standardmäßigen API-Version.
Die folgende Tabelle enthält eine kurze Beschreibung der einzelnen Funktionen. Wenn Sie Fragen zu den Funktionen oder zum Upgrade auf 3.0 haben, wenden Sie sich bitte an Ihren Engagement Lead oder Ihren Konsortialleiter.
Fähigkeit zum Lesen und Schreiben aller Zugehörigkeitstypen (Mitgliedschaft, Dienst, eingeladene Positionen, Auszeichnungen und Qualifikationen sind in früheren Versionen der API nicht verfügbar) |
Fähigkeit, Forschungsressourcen zu lesen und zu schreiben. |
Fähigkeit, Arbeitskennungen mit dem Beziehungstyp „Gefördert von“ zu lesen und zu schreiben. Dies wird verwendet, um Grant- oder Proposal-IDs mit Arbeitsmetadaten zu verknüpfen. |
Fähigkeit zum Lesen und Schreiben von Arbeitskennungen mit dem Beziehungstyp „Version von“. Dies wird verwendet, um andere Versionen des Werks miteinander zu verknüpfen. Ein Beispielanwendungsfall wäre die Verknüpfung des Preprints und des veröffentlichten Artikels. |
Fähigkeit, CRediT-Rollen in Werkmetadaten zu lesen und zu schreiben. |
Möglichkeit, die zusätzlichen Quellfelder zu lesen common:assertion-origin-client-id und dem common:assertion-origin-name für von der hinzugefügte Zugehörigkeiten ORCID Mitgliederportal und über Such- und Linkassistenten hinzugefügte Werke. |
Lese- und Schreibfähigkeit bei Arbeiten mit folgender Arbeitsart: Anmerkung Datenverwaltungspläne Dissertation Preprint physikalisches Objekt Überprüfen |
Möglichkeit, externe IDs für Zugehörigkeiten zu lesen und zu schreiben. |
Für das Hinzufügen von Zugehörigkeiten und Finanzierung sind Organisations-IDs erforderlich ORCID Records. |
Formalisierung von Identifikatoren – Wir haben ein neues vom System generiertes Feld eingeführt, das externe Identifikatoren (DOIs, PMCID, PMID, ArXiv, Bibcode, ISSNs und ISBNs) zum Zwecke des Abgleichs und der Gruppierung in einem normalisierten Format ausdrückt. Die Normalisierung erfolgt auf der Grundlage der Regeln des Bezeichnertyps und kann das Festlegen aller Buchstaben in Kleinbuchstaben oder das Umwandeln von Leerzeichen, Bindestrichen, Punkten und anderen Zeichen umfassen, die als gleichwertig behandelt werden können. Außerdem werden gegebenenfalls Standardpräfixe und -suffixe hinzugefügt. Zum Beispiel, https://doi.org/10.1/123, 10.1/123 und https://dx.doi.org/10.1/123 werden alle in diesem Feld als angezeigt https://doi.org/10.1/123. Der vorhandene Bezeichnerwert bleibt unverändert. |
Nähere Informationen finden Sie hier Hier .
API liest: Anzahl der API-GET-Aufrufe, die Ihre Integration im Laufe der Zeit durchgeführt hat.
Monatliche Integrations-Anmeldeveranstaltungen (ab Januar 2024): Anzahl der Anmeldungen im Laufe der Zeit, die über OAuth eine Verbindung zu Ihrer Integration hergestellt haben.
Suche nach einem Benutzer mit cURL wie folgt:
curl -iL https://orcid.org/0000-0000-0000-0000
Gibt 200 zurück, auch wenn der Benutzer nicht existieren. Um dies zu vermeiden, verwenden Sie in Ihrem Anruf die Inhaltsverhandlung wie folgt:
curl -iL -H 'Accept: application/xml' https://orcid.org/0000-0000-0000-0000
Der Prozess, um die Erlaubnis zum Hinzufügen oder Aktualisieren von Daten eines Benutzers zu erhalten ORCID Der Datensatz verwendet OAuth, wie in unserem beschrieben 3-beinige OAuth-FAQ. Nur ORCID Mitglieder können die Mitglieder-API verwenden, um Aktualisierungsberechtigungen anzufordern. Vereinfacht ausgedrückt funktioniert es so:
- Ihr lokales System erstellt einen speziellen Link
- Beim Anklicken wird der Benutzer weitergeleitet ORCID, meldet sich an und erteilt die Erlaubnis
- ORCID sendet den Benutzer mit einem „Autorisierungscode“ an Ihr System zurück
- Ihr System tauscht diesen Code gegen ein „Zugriffstoken“ aus.
- Mit dem Zugriffstoken können Sie den Benutzerdatensatz aktualisieren
Integration ORCID in Ihr System ermöglicht es Ihrer Organisation, authentifizierte Daten zu sammeln ORCID iDs und fügen Sie sie zu Ihren eigenen Daten hinzu. Gleichzeitig erteilt der Forscher der Organisation die Erlaubnis, von und zu lesen und zu schreiben ORCID Rekord.
Damit dies funktioniert, Organisationen MUST macht erhalten authentifiziert ORCID IDs Verwendung der ORCID OAuth-API. Dies bedeutet, dass sie eine enthalten ORCID Marken-Schaltfläche oder Link in ihrem System, der den Benutzer beim Klicken dazu auffordert, sich bei ihm anzumelden ORCID Rekord.
Sobald der Benutzer angemeldet ist, wird er aufgefordert, den Zugriff auf das System zu autorisieren ORCID iD
Die des Benutzers ORCID iD und Name auf dem ORCID Der Datensatz (abhängig von den Sichtbarkeitseinstellungen) wird im Rahmen dieses Prozesses an die Organisation zurückgegeben. Das System kann dann weitere Daten von der anfordern ORCID API.
Der oben beschriebene Workflow zum Sammeln authentifizierter APIs ist in beiden verfügbar ORCID's öffentliche und Mitglieder-APIs. Ersteres steht nichtkommerziellen Diensten kostenfrei zur Nutzung zur Verfügung.
Sie können Ihren Benutzern das Leben erleichtern, indem Sie validierte Informationen mit ihnen verknüpfen ORCID Aufzeichnungen. Sie tragen außerdem dazu bei, Vertrauen in die wissenschaftliche Kommunikation aufzubauen, und indem Sie diese Daten auf dem neuesten Stand halten, können Sie den Berichtsaufwand für Ihre Benutzer verringern und die Datenqualität verbessern.
ORCID für Forschungseinrichtungen
Zusätzlich zur Verwendung als dauerhafte Kennung für Ihre Forscher, ORCID kann Ihnen dabei helfen, die Kontrolle darüber zu behalten, wie der Name Ihrer Institution in Forschungssystemen verwendet wird. In Kombination mit anderen persistenten Identifikatoren ORCID ermöglicht es Ihnen, die Zugehörigkeit Ihrer Mitarbeiter, Lehrkräfte und Studenten zu Ihrer Institution verbindlich geltend zu machen. Sie können auch verwenden ORCID APIs, um Echtzeitbenachrichtigungen über Forschungsaktivitäten zu erhalten, Formulare automatisch zu aktualisieren und die Karrieren Ihrer Alumni zu verfolgen.
ORCID für Förderorganisationen
Durch Einbetten ORCID Mit iDs in Ihren Förderabläufen können Sie Ihre Stipendiaten und Förderprogramme zuverlässig verknüpfen – und allen Zeit sparen und Fehler reduzieren, die durch die manuelle Eingabe von Informationen entstehen. Benutzen ORCID In Ihren Systemen können Sie Ihren Teil zum Aufbau einer vertrauenswürdigen Forschungsinformationsinfrastruktur beitragen, indem Sie Verbindungen zwischen Einzelpersonen und den ihnen gewährten Zuschüssen herstellen.
ORCID für Verlage
Forscher stehen im Mittelpunkt aller Aktivitäten von Wissenschafts- und Forschungsverlagen. Genaue Autoren- und Gutachterinformationen sind für die Indizierung, Suche und Entdeckung, Veröffentlichungsverfolgung, Finanzierungs- und Ressourcennutzungszuordnung sowie die Unterstützung von Peer-Reviews von entscheidender Bedeutung.
ORCID dient als Informationsdrehscheibe und ermöglicht Ihren Autoren und Rezensenten eine zuverlässige Verbindung zu ihren Beiträgen und den Austausch von Informationen aus ihnen ORCID zeichnen Sie auf, wie sie mit Ihren Veröffentlichungssystemen interagieren. Das Sammeln von IDs für alle Ihre Autoren und Gutachter während des Veröffentlichungsprozesses – sei es für Bücher, Zeitschriften, Datensätze, Kompositionen, Präsentationen, Code oder eine Vielzahl anderer Werke – ermöglicht eine einfache Weitergabe von Informationen und stellt sicher, dass Forscher ihre Einwilligung zur Weitergabe erteilen können. spart Forschern Zeit und Ärger, verringert das Fehlerrisiko und ermöglicht es Forschern vor allem, die Anerkennung zu erhalten, die sie für die wichtige Arbeit, die sie leisten, verdienen.
ORCID ist bestrebt, transparente und vertrauenswürdige Verbindungen zwischen Forschern, ihren Beiträgen und ihren Zugehörigkeiten zu ermöglichen, indem Einzelpersonen eine eindeutige, dauerhafte Kennung bereitstellen, die sie bei der Teilnahme an Forschungs-, Wissenschafts- und Innovationsaktivitäten verwenden können. Sicherstellen, dass die korrekte ORCID iD Die Verbindung mit dem richtigen Forscher ist ein entscheidender Schritt beim Aufbau der Vertrauenswürdigkeit des ORCID Datensatz und das breitere Ökosystem der wissenschaftlichen Kommunikation. Aus diesem Grund, ORCID erlaubt nicht die manuelle Erfassung oder Eingabe von ORCID IDs in jedem Workflow, in dem eine Erfassung möglich ist ORCID Ausweise direkt von den Rekordhaltern selbst.
Forscher können ihre Daten einfach und sicher teilen ORCID iDs mit den Systemen, mit denen sie interagieren, was beweist, dass sie deren Besitzer sind ORCID Ausweis. Diese Systeme können dann Informationen über Forscheraktivitäten mit anderen Systemen teilen, wodurch eine Kette validierter und vertrauenswürdiger Aussagen über Forscheraktivitäten entsteht. Das Endergebnis ist, dass der richtigen Person in einem breiten Spektrum wissenschaftlicher Informationsabläufe die richtigen Aktivitäten zugeordnet werden.
Für weitere Informationen siehe: https://info.orcid.org/collecting-and-sharing-orcid-ids/
Neben dem Zugriff auf die Mitglieder-API profitieren Sie außerdem von:
- Technischer und kommunikativer Support von ORCID Mitarbeiter, die in 14 Ländern auf der ganzen Welt ansässig sind und zusammen 13 Sprachen sprechen
- Als Informationsquelle aufgeführt sein, die Sie ergänzen ORCID Aufzeichnungen
- Erhalten Sie regelmäßig Berichte über die Nutzung Ihrer ORCID Integration (monatlich für Premium-Mitglieder, zweimal jährlich für Basis-Mitglieder)
- Erhalten Sie eine Vorwarnung ORCID Neuigkeiten, Updates und Veranstaltungen über unseren monatlichen Mitglieder-Newsletter
- Die Möglichkeit, jemanden aus Ihrer Organisation als Kandidat zu nominieren ORCID Vorstand und Abstimmung bei unseren jährlichen Vorstandswahlen
ORCID Durch die Mitgliedschaft können Sie mehr als nur sammeln ORCID IDs. Es berechtigt Sie zum Zugriff auf ORCID Mitglieder-API, was bedeutet, dass Sie Informationen mit Ihren Autoren und Gutachtern verbinden können. ORCID Aufzeichnungen, und Sie können Informationen in ihren Aufzeichnungen lesen, die sie als vertrauenswürdige Parteien markiert haben (ORCID Mitglieder) sowie deren öffentlich zugängliche Informationen.
Jede Zeitschrift oder Organisation kann iDs sammeln, ohne beizutreten ORCID, über unsere öffentliche API. ORCID Für die Mitgliedschaft muss Ihre Zeitschrift einen jährlichen Mitgliedsbeitrag zahlen.
Bitte kontaktieren Sie uns, wenn Sie Probleme im Zusammenhang mit dieser Website haben oder Füllen Sie dieses Formular aus oder Sie kontaktieren uns unter [E-Mail geschützt]
Sie können überprüfen, unsere Liste der Mitglieder
Ihre Zeitschrift ist kein Mitglied in dem Sinne, dass Sie direkten technischen Support erhalten oder sich dafür einsetzen können ORCID Vorstand/Stimme bei Vorstandswahlen. Abhängig von der Art der Mitgliedschaft Ihres Verlags oder Ihrer Institution haben Sie jedoch möglicherweise Zugriff auf andere Mitgliedervorteile, z. B. die Nutzung der Mitglieder-API.
Ja – unsere Gebühren finden Sie auf unserer Mitgliedschaftsseite
Bitte beachten Sie unsere Markenrichtlinien zur Anzeige ORCID in Zeitschriftenartikeln.
Ja (siehe Frage 10)
- Die öffentliche API steht jedem zur Nutzung zur Verfügung. Es muss mit dem eines einzelnen Benutzers verknüpft sein ORCID iD und wenn diese Person Ihre Organisation verlässt, müssen Sie neue Anmeldeinformationen einrichten. Sie können die öffentliche API verwenden, um authentifizierte Daten zu sammeln ORCID iDs und zum Einlesen öffentlich zugänglicher Informationen ORCID Aufzeichnungen
- Die Mitglieder-API steht nur Mitgliedern zur Verfügung. Neben der Erfassung authentifizierter IDs und dem Lesen öffentlich verfügbarer Informationen können Sie auch als vertrauenswürdige Parteien gekennzeichnete Informationen lesen und Informationen mit diesen verknüpfen ORCID Aufzeichnungen, zum Beispiel über die Veröffentlichungen Ihrer Autoren. Mit der Basismitgliedschaft haben Sie Anspruch auf einen Satz Zugangsdaten (eine Integration), während Sie mit der Premium-Mitgliedschaft bis zu fünf Sätze Zugangsdaten (fünf Integrationen) erhalten.
ORCID Die automatische Aktualisierung ermöglicht es Autoren, ihre zu haben ORCID Datensätze werden automatisch aktualisiert. Es funktioniert so:
- Der Verlag erhebt die Autorenrechte ORCID iD während des Veröffentlichungsprozesses (normalerweise während der Einreichung des Manuskripts)
- Der Herausgeber umfasst die iD in den Metadaten bei der Registrierung eines DOI für die Veröffentlichung
- Der Autor erhält eine E-Mail vom DOI-Register (derzeit Crossref), in der er um Erlaubnis zur Aktualisierung seines Eintrags gebeten wird ODER der Autor erstellt ein DataCite-Profil und verknüpft es mit seinem ORCID Rekord
- Der Autor erteilt Crossref oder DataCite die Erlaubnis, ihre Inhalte zu aktualisieren ORCID aufzeichnen (Sie müssen dies nur einmal tun)
- Jedes Mal, wenn Crossref oder DataCite einen DOI registrieren, der die Autoren enthält ORCID iD Sie aktualisieren ihren Datensatz automatisch
Für weitere Informationen, siehe https://www.crossref.org/community/orcid/
Ja. Für weitere Informationen lesen Sie bitte unsere Dokumentation
ORCID Ausweise sind nur für Einzelpersonen bestimmt. Verlage interagieren mit ORCID durch die Integration mit unseren APIs zum Sammeln von IDs und zum Importieren und Exportieren von Daten von und nach ORCID Aufzeichnungen. Erfahren Sie mehr in unserem Veröffentlichung der Workflow-Dokumentation
DOIs sind dauerhafte Identifikatoren für Objekte, am häufigsten für Veröffentlichungen aller Art (Zeitschriftenartikel, Bücher, Buchkapitel, Datensätze usw.). ORCID iDs sind dauerhafte Identifikatoren für Personen und insbesondere für Personen, die in der Forschungsgemeinschaft tätig sind – sei es direkt zum Beispiel als Forscher, Autoren oder Gutachter – oder in unterstützenden Rollen wie Bibliothekaren, Verlegern, Geldgebern usw.
ORCID stützt sich auf zwei Mechanismen zur Übermittlung personenbezogener Daten im Rahmen der DSGVO. Erste, ORCID holt zum Zeitpunkt der Registrierung die Einwilligung seiner Nutzer zur Übermittlung personenbezogener Daten aus der EU in die USA ein. Zweite, ORCID schließt bei Bedarf Standardvertragsklauseln (SCCs) mit Mitgliedsorganisationen ab.
Ja, ORCID überträgt im Rahmen seiner Netzwerkinfrastruktur personenbezogene Daten aus der EU in die USA. Die Live-Registrierungssoftware wird auf Servern in den USA gehostet.
Ja, zusätzlich zu den oben besprochenen Schutzmaßnahmen ORCID umfasst die folgenden ergänzenden Maßnahmen zum Datenschutz.
Kontrolle der betroffenen Person. Den Benutzern wird ein hohes Maß an Transparenz und Kontrolle in Bezug auf die mit ihnen geteilten Informationen geboten ORCID und andere Benutzer oder Mitgliedsorganisationen. ORCID hat Maßnahmen ergriffen, um die Menge der personenbezogenen Daten zu minimieren, die für die Einrichtung eines Unternehmens erforderlich sind ORCID erfassen, wobei lediglich ein Vorname und eine E-Mail-Adresse erforderlich sind. Zusätzlich, ORCID macht deutlich, dass seine Tools und Dienste Benutzern die Kontrolle über die Registrierung geben, was mit einer iD verbunden ist und wer auf Benutzerinformationen zugreifen kann.
Vereinbarungen zur Auftragsverarbeitung mit Drittanbietern. ORCID schließt mit seinen Auftragsverarbeitern Vereinbarungen ab, die Datenschutz- und Sicherheitsbestimmungen beinhalten. Vor dem Abschluss von Verträgen mit Auftragsverarbeitern ORCID führt eine Due-Diligence-Prüfung durch, die sich mit Datenschutz- und Sicherheitskomponenten befasst. Um diese Due Diligence durchzuführen, ORCID stellt zunächst fest, ob der Drittanbieter Zugriff auf personenbezogene Daten hat und/oder Kopien davon erhält. Wenn die Antwort ja ist, dann ORCID treibt die Aushandlung einer Datenverarbeitungsvereinbarung voran, die den Anforderungen der DSGVO und allen anderen geltenden Datenschutzanforderungen entspricht.
Datenverschlüsselung. ORCID implementiert angemessene Verschlüsselungsmaßnahmen für alle Daten im Ruhezustand und während der Übertragung. Darüber hinaus sind alle Backups verschlüsselt.
Technische und organisatorische Maßnahmen. ORCID implementiert eine Vielzahl von Sicherheitskontrollen, um die sichere Verwaltung seiner Datenbanken und Infrastruktur zu unterstützen. Zu diesen Sicherheitskontrollen gehören die Verwaltung von Sicherheitspatches; Überwachung des Systemzugriffs; Audit-Protokollierung; Zugangskontrolle; und Änderungskontrollmechanismen. Zusätzlich, ORCID unterhält einen Notfallreaktionsplan sowie einen Notfall- und Datenwiederherstellungsprozess.
Ja, ORCID pflegt auf seiner Website eine Reihe von Dokumenten, die sich auf seine Datenschutz- und Sicherheitspraktiken beziehen. Zu diesen Dokumenten gehören:
- Datenschutz-Bestimmungen - ORCID
- ORCID Vertrauen - ORCID
- ORCID, DSGVO und Ihre Rechte als Nutzer ‚ORCID
TRUSTe-Bescheinigungsschreiben (Microsoft Word – Zertifizierungsbescheinigung_ORCID20191220.docx)
ORCID schließt gerne die Standardvertragsklauseln mit jedem Mitglied in der EU, im EWR oder im Vereinigten Königreich ab, an das personenbezogene Daten übermittelt werden ORCID mithilfe der Member-API. Bitte wenden Sie sich an Ihren ORCID Kontaktieren Sie das Engagement-Team, um die Aufnahme der Standardvertragsklauseln in Ihre Mitgliedschaftsvereinbarung zu besprechen.
Das ist unwahrscheinlich ORCID würde den in der Schrems-II-Entscheidung hervorgehobenen Anforderungen des US-Überwachungsrechts unterliegen. Seit ORCID ist kein „Anbieter elektronischer Kommunikationsdienste“ im Sinne von Abschnitt 50 USC § 1881(b)(4) und unterliegt nicht dem Foreign Intelligence Services Act („FISA“). ORCID stellt ein Online-Register bereit, das zur Identifizierung von Forschern aus Mitgliedsorganisationen verwendet wird; Daher würde Abschnitt 702 des FISA nicht auf diese Anwendung anwendbar sein ORCID und seine Daten.
Ja, ORCID macht den Benutzern klar, dass sie im Falle einer behördlichen Datenanfrage „nur solche Daten bereitstellen wird, die wir in der jeweiligen Situation für notwendig erachten“. Sehen Datenschutzerklärung, Abschnitt 6.4. Weiter ORCID stellt klar, dass es, sofern dies zulässig ist, „den relevanten Dateninhabern umgehend Informationen über alle eingegangenen behördlichen Datenanfragen und betroffenen Konten zur Verfügung stellen wird“. Ausweis.
Ja, ORCID unterscheidet nicht zwischen Benutzern mit Sitz in der EU oder außerhalb der EU. Während in bestimmten Regionen möglicherweise unterschiedliche Datenschutzgesetze gelten, ORCID ist bestrebt, allen Benutzern Datenschutz gemäß seiner Datenschutzrichtlinie zu bieten, die Sie unter finden https://info.orcid.org/privacy-policy/.
Ja. Jeder, der an Forschung, Wissenschaft oder Innovation beteiligt ist, kann sich registrieren ORCID iD kostenlos für sich selbst nutzen und nutzen können iD während Ihrer gesamten Karriere, auch wenn sich Ihr Name ändert oder Sie zu einer anderen Organisation, Disziplin oder einem anderen Land wechseln.
Gehe zu unserem Passwort vergessen Seite, wählen Sie die Passwort Geben Sie Ihre registrierte E-Mail-Adresse in das E-Mail-Feld ein und wählen Sie die Option aus Kontodetails wiederherstellen Taste. Wir senden Ihnen eine E-Mail mit Schritten zum Zurücksetzen Ihres Passworts.*
*Wenn nein ORCID iD Wenn Sie mit der von Ihnen eingegebenen E-Mail-Adresse verknüpft sind, werden Sie in der E-Mail, die Sie von uns erhalten, darüber informiert. An diesem Punkt können Sie versuchen, Ihr Passwort mit einer anderen E-Mail-Adresse zurückzusetzen (versuchen Sie es mit einer privaten oder einer beruflichen E-Mail-Adresse). Bitte lesen Sie unseren Artikel über vergessene Passwörter um mehr zu erfahren.
ORCID Bezeichner, die mit X enden, sind gültig und korrekt.
ORCID Identifikatoren werden alle zufällig zugewiesen und können nicht geändert werden. Das letzte Zeichen in einem ORCID Der Bezeichner ist eine Prüfsumme. Der Wertebereich liegt zwischen „0“ und „10“, wobei X den Wert „10“ darstellt. Die Prüfsumme stellt sicher, dass die anderen 15 Ziffern Ihrer Kennung eine zusammenhängende ID bilden.
Sie können mehr erfahren, indem Sie darüber lesen die Struktur eines ORCID Kennzeichnung.
Gehe zu unserem Passwort vergessen Seite, wählen Sie die ORCID iD Geben Sie Ihre registrierte E-Mail-Adresse in das E-Mail-Feld ein und wählen Sie die Option aus Kontodetails wiederherstellen .
Wir senden Ihnen eine E-Mail von [E-Mail geschützt] , um Ihnen Ihre 16-stellige Zahl mitzuteilen ORCID Identifikator. Bitte sehen ich habe meine ... vergessen ORCID iD, wie kann ich es wiederherstellen? um mehr zu erfahren.
Wenn Sie sich an Ihr Passwort erinnern, versuchen Sie, sich unter anzumelden https://orcid.org/signin Verwenden Sie Ihre 16-stellige Zahl ORCID iD oder Ihre bisherige E-Mail-Adresse als Benutzernamen.
Wenn Sie Ihr Passwort vergessen UND den Zugriff auf zuvor registrierte E-Mails verloren haben, wenden Sie sich bitte an uns kontaktiere uns und beinhalten:
- Name
- ORCID ID(s), von denen Sie glauben, dass sie Ihnen gehören könnten
- Alle früheren E-Mail-Adressen, mit denen Sie sich möglicherweise registriert haben
- Eine aktuelle institutionelle oder geschäftliche E-Mail-Adresse (falls möglich)
Diese Informationen erleichtern es uns, Potenziale zu erkennen ORCID Aufzeichnungen, die möglicherweise Ihnen gehören, und ermöglichen Ihnen eine schnellere Abwicklung.
Bitte ansehen Wie kann ich auf meine . zugreifen ORCID aufzeichnen, wenn ich die damit verknüpfte E-Mail-Adresse nicht mehr habe für mehr Informationen. Hinweis: Um dies in Zukunft zu verhindern, empfehlen wir Hinzufügen mehrerer E-Mail-Adressen auf Ihre ORCID Konto.
Wenn Sie innerhalb von 10 Minuten keine E-Mail erhalten, kann das drei Ursachen haben:
- Unsere E-Mail wurde in Ihren Spam- oder Junk-Ordner weitergeleitet. Bitte überprüfen Sie Ihren Spam- oder Junk-Ordner auf Nachrichten von ORCID.
- Die eingegebene E-Mail-Adresse enthält einen Tippfehler. Bitte versuche es erneut.
- Möglicherweise hat Ihr E-Mail-Administrator unsere Nachrichten blockiert. Bitte kontaktieren Sie uns, wenn Sie glauben, dass dies der Fall ist.
Das häufigste Problem, das wir von Benutzern hören, ist der Verlust des Zugriffs auf ihre früheren E-Mail-Adressen, die in ihren Konten registriert waren.
Wir empfehlen dringend, mindestens eine Backup-E-Mail-Adresse hinzuzufügen, damit Sie den Zugriff auf Ihre wiederherstellen können ORCID aufzeichnen, falls Sie den Zugriff auf eine andere E-Mail verlieren.
Wenn Sie vergessen haben, welche E-Mail-Adresse Sie registriert haben ORCID Konto mit, gehen Sie bitte zu unserem Passwort vergessen Seite. Wähle aus ORCID iD Option und geben Sie dann alle E-Mail-Adressen ein, mit denen Sie sich möglicherweise registriert haben.
Wir senden Ihnen eine E-Mail mit der Angabe Ihrer 16-stelligen Zahl ORCID Kennung.
Wenn in der E-Mail steht, dass wir keine finden konnten ORCID iD mit der E-Mail-Adresse verknüpft ist, wiederholen Sie dann den oben beschriebenen Vorgang mit Ihren anderen aktuellen E-Mail-Adressen (privat und beruflich), um die E-Mail-Adresse wiederherzustellen ORCID Ausweis.
Wenn Sie alle anderen Möglichkeiten ausgeschöpft haben, kontaktieren Sie uns bitte mit Ihrem vollständigen Namen, Ihrer 16-stelligen Ziffer ORCID Kennung und alle E-Mail-Adressen, mit denen Sie sich möglicherweise für ein Konto registriert haben. Hinweis: Um dies in Zukunft zu verhindern, empfehlen wir Hinzufügen mehrerer E-Mail-Adressen auf Ihre ORCID Konto.
Sie können Ihren doppelten Datensatz schnell und einfach entfernen, indem Sie zu Ihrem gehen Kontoeinstellungen und Auswählen Doppelten Datensatz entfernen. Sie werden dann aufgefordert, die E-Mail-Adresse oder einzugeben ORCID iD des doppelten Datensatzes sowie das Passwort.
Wenn der doppelte Datensatz entfernt wird, wird die damit verbundene E-Mail-Adresse zu Ihrer primären E-Mail-Adresse hinzugefügt ORCID Datensatz gelöscht und alle anderen Informationen im Datensatz werden gelöscht.
Weitere Informationen finden Sie unter Entfernen Ihres Zusatzes oder Duplikats ORCID iD.
Wenn Sie keinen Zugriff mehr auf dieses E-Mail-Konto haben und sich nicht an das Passwort erinnern, kontaktieren Sie uns bitte unter Angabe Ihres vollständigen Namens, Ihrer 16-stelligen Zahl ORCID Kennung und alle E-Mail-Adressen, mit denen Sie sich möglicherweise für ein Konto registriert haben.
Sie erhalten eine Benachrichtigung in ihrem ORCID Posteingang. Immer wenn sich die Daten ändern ORCID Datensatz erhält der Benutzer eine Benachrichtigung mit grundlegenden Informationen über die Änderung, einschließlich des Namens des Clients, der die Aktualisierung durchführt, des Änderungsdatums und des Elements im ORCID Datensatz, der aktualisiert wurde. Sehen Sie sich unsere an Weitere Informationen zu Benachrichtigungen finden Sie in der Benutzer-Wissensdatenbank.
ORCID Datensätze auf der Sandbox haben auch funktionierende Posteingänge. Wir empfehlen Ihnen, die Posteingänge Ihrer Tests regelmäßig durchzusehen ORCID Aufzeichnungen, wenn Sie planen, wie Ihre Systeme Datenaktualisierungen planen.
ORCID verpflichtet sich zu Offenheit und Transparenz. Damit ist unsere gemeint Produkt-Roadmap ist für jedermann einsehbar, ebenso wie die Arbeit, die sich derzeit in der Entwicklung befindet.
Die Produkt-Roadmap ist von zentraler Bedeutung ORCID Produktentwicklungsprozess. Die Anforderungen wandern von den vom Team verwalteten Trello-Boards über das Trello-Board „Produkt-Roadmap“ zum Trello-Board „Aktuelle Entwicklung“, wo sie implementiert und in unsere Produktionssysteme verschoben werden.
Dieses Board enthält klar definierte Anforderungen, deren Umsetzung geplant ist irgendwannsowie eine Liste priorisierter Anforderungen, deren Umsetzung in naher Zukunft geplant ist.
Woher kommen Anforderungen?
Anforderungen werden aus vielen Quellen gesammelt von ORCID Mitarbeiter. Sie können unter anderem aus Mitgliedsanfragen, Konsortium-Feedback, Benutzertests, strategischen Projekten und Fehlerberichten stammen. Darüber hinaus alle ORCID Teams generieren ihre eigenen internen Anforderungen, wie z. B. Website-Änderungen, Infrastruktur-Upgrades und Betriebssystem-Updates. Jede Karte ist mit dem Team gekennzeichnet, das die Anforderung erstellt hat – Kommunikation, Strategie, Technik, Engagement oder Betrieb.
Wie sieht es mit der Roadmap aus?
ORCID strebt einen ausgewogenen Produktentwicklungszyklus an und führt regelmäßige teamübergreifende Treffen durch, um kurz- und langfristige Prioritäten zu besprechen. Wir versuchen unser Bestes, um Fehler, neue Funktionen, technische Schulden, Website-Updates und strategische Punkte gleichermaßen zu beheben.
Wie kann ich zur Roadmap beitragen?
Wir freuen uns über Verbesserungsvorschläge ORCID Registrierung. Bitte senden Sie Ihr Feedback an unser Team.
Zudem hat auch Frau ORCID ist ein Open-Source-Projekt und wir freuen uns über Beiträge zu unserem Quellcode sowie über alle anderen unsere Repositories.
Updates und andere Ankündigungen für API-Benutzer werden über geteilt ORCID API-Benutzergruppe. Sie können auch allgemeine Nachrichten und Updates über die abonnieren ORCID Blog.
ORCID Mitglieder erhalten außerdem die ORCID Mitglieder-Newsletter, in dem diese Informationen enthalten sind. Zum Schluss noch der technische Ansprechpartner für alle ORCID Mitglieder mit einer aktiven, benutzerdefinierten Integration erhalten außerdem E-Mail-Nachrichten über alle wichtigen Aktualisierungen der ORCID Registrierung. Wenn Sie als technischer Ansprechpartner für Ihre Organisation aufgeführt werden möchten, wenden Sie sich bitte an uns kontaktiere uns.
Der Mitglieder-Newsletter wird monatlich verschickt von ORCID enthielt zuvor einen Link zu einem Google Drive-Ordner, in dem alle Ihre Mitgliederberichte gespeichert waren. Dies wurde nun durch neue Berichte ersetzt, die allen Mitgliedern im zur Verfügung stehen Mitgliederportal.
Frühere Berichte:
- Premium-Mitglieder mit aktiven Integrationen Sie erhalten einen eindeutigen Link zu einem Ordner mit separaten, benutzerdefinierten Berichten mit Daten für jede Integration im Vormonat.
- Premium-Mitglieder, die noch keine aktive Integration haben Sie erhalten einen eindeutigen Link zu einem Ordner mit benutzerdefinierten Berichten mit E-Mail-Statistiken für ihre Institution sowie einen Link zu einem Ordner, der allgemeine Berichte mit aggregierten Daten für alle aktiven Mitgliederintegrationen enthält.
- Grundlegende Mitglieder Sie erhalten einen Link zu einem Ordner mit allgemeinen Berichten, die zweimal jährlich mit aggregierten Daten für alle aktiven Mitgliederintegrationen im vorangegangenen Halbjahr herausgegeben werden. Der Halbjahresbericht wird veröffentlicht Juli (Daten von Januar bis Juni), der zweite Halbjahresbericht, veröffentlicht in Januar (Juli-Dezember des Folgejahres).
Wenn Sie sind ORCID Wenn Sie Mitglied sind und den monatlichen Mitglieder-Newsletter derzeit nicht erhalten, wenden Sie sich bitte an [E-Mail geschützt]
Premium-Mitglieder mit aktiven Integrationen
Der Google Drive-Ordner enthält einen Mitgliedsbericht für jede der Ihnen ausgestellten Produktions-Client-IDs. Die Dateinamen enthalten den Anzeigenamen des Clients iD und das Datum des Berichts; Bitte sortieren Sie nach Änderungsdatum, um den neuesten Bericht zu finden. Außerdem gibt es einen Ordner „raw_data“, der die zur Erstellung des Berichts verwendeten Daten enthält und bei Bedarf für weitere Analysen zur Verfügung steht.
Premium-Mitglieder, die noch keine aktive Integration haben
Der Google Drive-Ordner enthält einen Mitgliederbericht nur mit E-Mail-Statistikdaten sowie einen Link zu einem Google Drive-Ordner mit allgemeinen monatlichen Berichten mit aggregierten Daten für alle aktiven Mitgliederintegrationen für das aktuelle und frühere Jahr. Für diese Berichte sind keine Rohdaten verfügbar.
E-Mail-Domain zählt
In diesem Abschnitt werden die Anzahl angegeben ORCID iDs hat derzeit die E-Mail-Domäne(n) Ihrer Institution über alle Zeiträume hinweg registriert. Um diese Zählungen zu generieren, suchen wir nach Domains, die mit der Website-URL übereinstimmen, die wir für Ihre Organisation gespeichert haben (z. B. wenn Ihre Website-URL www.universitycollege.edu lautet, suchen wir nach E-Mails, die auf @universitycollege enden). Wenn wir keine Website-URL gespeichert haben, wird in diesem Abschnitt „√∫Keine E-Mail-Domänen angegeben“ angezeigt. Wenn wir Ihre E-Mail-Domain nicht ganz richtig verstanden haben oder Sie weitere Domains hinzufügen möchten, wenden Sie sich bitte an uns kontaktiere uns.
- Datensätze, die für Ihre E-Mail-Domänen registriert sind¬¨‚Anzahl der eindeutigen ORCID IDs, die eine Adresse innerhalb der E-Mail-Domäne(n) Ihrer Institution enthalten
- Datensätze, die für Ihre E-Mail-Domänen registriert UND mit Ihrer Kunden-ID verknüpft sind¬¨‚Anzahl der eindeutigen ORCID IDs, die eine Adresse innerhalb der E-Mail-Domäne(n) Ihrer Institution enthalten UND die Ihre Institution als vertrauenswürdige Partei enthalten (d. h. Datensätze, für die Ihre Institution über ein gültiges Zugriffstoken verfügt)
Datensätze erstellt und beansprucht
(Hinweis: Die meisten Kunden haben diesen Abschnitt nicht in ihren Berichten.)
Wenn Sie einen institutionellen Kunden haben, der zur Erstellung von Datensätzen im Auftrag von Forschern über die API verwendet wurde, erhalten Sie einen Abschnitt mit der Bezeichnung „Registrierungsstatistik“. Dazu gehören Informationen über die Anzahl der von Ihnen erstellten Datensätze und wie viele beansprucht wurden (die Datei „raw_data“ enthält weitere Informationen über die spezifischen Datensätze, die zur Generierung dieser Zahlen verwendet wurden).
Nutzer
Dieser Abschnitt des Berichts enthält die Gesamtzahl der Forscher, die Ihre Integration für die Verbindung verwendet haben ORCID iD in Ihrem System im Laufe des Monats der Berichterstattung. Darüber hinaus wird die Gesamtzahl der Forscher angegeben, die sich für eine neue Studie angemeldet haben ORCID iD als Teil der iD Verbindungsprozess.
Die Grafik mit der Bezeichnung „Gesamtintegrationsereignisse“ zeigt die Anzahl der Forscher pro Tag, die Ihre Integration im letzten Monat genutzt haben
Events
Der Bericht enthält auch Veranstaltungen Informationen, die Aktionen, die der Forscher beim Verbinden durchgeführt hat ORCID im Berichtsmonat mit Ihrem System erfassen. Jedes Ereignis stellt einen beliebigen Zugriff dar, den der Benutzer gewährt hat, oder eine Aktion, die er darauf ausgeführt hat ORCID Website (z. B. Anmelden oder Gewähren von eingeschränktem Lesezugriff). Mit den meisten Forschern ist mehr als ein Ereignis verbunden.
Wenn an ein Ereignis ein ‚√∫√π angehängt ist, bedeutet dies, dass der Forscher ein langlebiges (PPersistenter) Token, im Vergleich zu einem kurzlebigen Token, der in einer Stunde abläuft. Seit März 2018 werden auf dem nur noch langlebige Token unterstützt ORCID Register; Ihr integriertes System oder der Benutzer können das Token jederzeit widerrufen.
Benutzer nach Land
Der letzte Abschnitt der Berichte enthält Informationen über die Forscher, die Ihre Integration verwendet haben, aufgeschlüsselt nach dem Land, aus dem sie auf Ihre Integration zugegriffen haben. Diese Daten werden aus der IP-Adresse eines Forschers oder seiner geografischen ID abgeleitet (die von Google anhand der IP-Adresse des Forschers ermittelt wird).
Probennahme
Weil so viele Forscher das verwenden ORCID Registry ist es nicht möglich, Berichte über den gesamten Datensatz der Forscher zu erstellen. Stattdessen werden die hier bereitgestellten Zahlen anhand von Trends aus einer Stichproben- und Nicht-Stichprobenmenge ermittelt. Die aus Stichprobendaten abgeleiteten Abschnitte des Berichts sind mit einem Sternchen gekennzeichnet, und die Stichprobengröße und der Platz werden auf der Registerkarte „Analytics-Daten“ angegeben. Die Zahlen im Google Analytics-Abschnitt des Berichts stimmen möglicherweise nicht vollständig mit den von Ihnen geführten lokalen Statistiken überein, und es kann zu geringfügigen Abweichungen bei der Zählung zwischen den Abschnitten des Berichts kommen.
Die unter „Integration Analytics“ aufgeführten Stichprobenparameter gelten für alle mit einem Sternchen gekennzeichneten Abschnitte. Der Prozentsatz der von den Analysedaten erfassten Sitzungen beträgt (Stichprobengröße)/(Stichprobenbereich) * 100 %. Weitere Informationen zur Probenahme finden Sie unter Google Entwickler.
Leere Berichte
Die Abschnitte „Benutzer“ und „Ereignisse“ des Berichts enthalten nur Daten des letzten Monats. Wenn im letzten Monat kein Forscher Ihre Integration genutzt hat, werden keine Daten zurückgegeben.
Fragen
Wenn Sie Fragen zu Ihren Mitgliedsberichten haben, wenden Sie sich bitte an uns kontaktiere uns.
Ein Preprint ist ein vollständiges wissenschaftliches Manuskript, das von den Autoren auf einen öffentlichen Server hochgeladen wird. Der Vorabdruck enthält vollständige Daten und Methoden; Oft wird dasselbe Manuskript bei einer Zeitschrift eingereicht. Nach einer kurzen Qualitätskontrolle, um sicherzustellen, dass die Arbeit wissenschaftlicher Natur ist, wird das Manuskript des Autors innerhalb von etwa einem Tag ohne Peer-Review im Internet veröffentlicht und kann von jedem auf der Welt kostenlos eingesehen werden. Basierend auf Rückmeldungen und/oder neuen Daten können neue Versionen Ihres Vorabdrucks eingereicht werden; Allerdings bleiben auch frühere Preprint-Versionen erhalten. Mit Preprint-Servern können Wissenschaftler die Verbreitung ihrer Arbeit an die weltweite wissenschaftliche Gemeinschaft direkt steuern. In den meisten Fällen wird die gleiche Arbeit, die als Vorabdruck veröffentlicht wurde, auch zur Begutachtung durch Fachzeitschriften bei einer Zeitschrift eingereicht. Somit funktionieren Preprints (schnell, aber nicht durch Peer-Review validiert) und Zeitschriftenveröffentlichungen (langsam, aber mit Validierung durch Peer-Review) parallel als Kommunikationssystem für die wissenschaftliche Forschung.
Sehen Sie sich das Video auf YouTube an
Hinweis: Dieser Inhalt und dieses Video erschienen ursprünglich auf der ASAPBio-Website Vielen Dank an ASAPBio für die Bereitstellung unter einer CC-BY-Lizenz!
Das eduPerson-Schema hat Folgendes hinzugefügt: eduPersonOrcid Attribut in seinem Februar 2016 Update.
Gemäß der eduPerson-Spezifikation:
RFC4512 definition
( 1.3.6.1.4.1.5923.1.1.1.16
NAME 'eduPersonOrcid'
DESC 'ORCID researcher identifiers belonging to the principal'
EQUALITY caseIgnoreMatch
SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' )
Beachten Sie, dass das Format für dieses Feld das ist ORCID-bevorzugte URI-Darstellung der iD, Ie https://orcid.org/0000-0001-5727-2427.
Weitere Informationen zum Format des ORCID iD kann gefunden werden in Struktur der ORCID Kennzeichnung.
Der ORCID Die Registrierung ist so konzipiert, dass Benutzer ihre IDs mithilfe von OAuth an Organisationen weitergeben können, wodurch sichergestellt wird, dass sie korrekt sind iD wird für jeden Forscher erhoben. Wir raten Organisationen davon ab, etwas hinzuzufügen ORCID iDs zu ihren Systemen basierend auf einer Suche nach Forschern nach Namen. Es kann jedoch hilfreich sein herauszufinden, wie viele Forscher es in Ihrer Organisation gibt ORCID iDs, die über die API erfolgen können. Nachfolgend finden Sie Vorschläge für die Suche nach Organisation.
Eine Einführung in die Suche, wie Sie ein Zugriffstoken erhalten, wie Sie Ihre Suchergebnisse verstehen und Einzelheiten zu anderen Feldern, die durchsucht werden können, finden Sie in unserem Durchsuchen des Registrierungs-API-Tutorials
Suche nach Name und DOI
Bei der Überprüfung, ob eine Person eine hat ORCID Wir empfehlen Ihnen, sowohl nach ihrem Namen als auch nach dem DOI eines oder mehrerer ihrer jüngsten Werke zu suchen. Das Ergebnis sollte nur der Eintrag des Forschers sein, nach dem Sie suchen, und nicht der Eintrag einer anderen Person mit demselben Namen.
Ein Beispielaufruf zur Suche nach allen Datensätzen mit dem Namen „Laurel Haak“ und entweder dem DOI 10.1087/20120404 oder dem DOI 10.6084/M9.FIGSHARE.1115124:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search?q=family-name:Haak+AND+given-names:Laurel+AND+digital-object-ids:%2210.1087/20120404%22+OR+digital-object-ids:%2210.6084/M9.FIGSHARE.1115124’%22
Suche nach Zugehörigkeit
Die Zugehörigkeitsfelder können entweder nach dem Namen der Zugehörigkeit oder nach der eindeutigen ROR-ID oder GRID-ID der Organisation durchsucht werden. (Die GRID-ID Ihrer Organisation finden Sie unter GRID oder Ihre ROR-ID im ROR-Registrierung)
Suche nach Organisationsnamen
Method: GET Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:"University+of+Johannesburg"
Oder für eine exakte Übereinstimmung
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:(%22Boston%20University%22)
Suche nach GRID-ID
Ein Beispielaufruf zur Suche nach allen Datensätzen mit der GRID-ID grid.5509.9 (Universität Tampere):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=grid-org-id:grid.5509.9
Suche nach ROR-ID
Ein Beispielaufruf zur Suche nach allen Datensätzen mit der ROR-ID 04fa4r544 (ORCID):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=ror-org-id:"https://ror.org/04fa4r544"
Suche nach E-Mail-Domäne
Sie können die API verwenden, um nach Forschern anhand der E-Mail-Domäne zu suchen. Bedenken Sie, dass etwa 97 % der E-Mail-Adressen in ORCID sind privat und alle Datensätze mit einer privaten oder vertrauenswürdigen E-Mail-Adresse werden bei dieser Suche nicht zurückgegeben.
Ein Beispielaufruf zum Suchen nach allen Datensätzen mit einer @orcid.org-E-Mail-Adresse:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=email:*@orcid.org
Suchergebnisse werden im CSV-Format zurückgegeben
Suchergebnisse können auch im CSV-Format zurückgegeben werden. Im Rahmen des Aufrufs können Sie die Ausgabespalten aus einer Liste verfügbarer Felder unten angeben:
orcid
E-Mail
Vorname
Nachname
Vor- und Nachnamen
Kreditname
anderer Name
Name der aktuellen-Institution-Zugehörigkeit
Name der früheren-Institution-Zugehörigkeit
Mit Ihren Anmeldeinformationen müssen Sie den Header wie folgt angeben:text/csv'. Im Rahmen des Suchaufrufs müssen Sie der Abfrage auch die Felder hinzufügen, die Sie in der Ausgabe benötigen.
Suchen Sie nur mit Ihrem Browser
Sie können die Suche auch über Ihren Browser abschließen. Die URL ist auf die gleiche Weise aufgebaut, Sie müssen jedoch keine API-Anmeldeinformationen verwenden. Bitte beachten Sie, dass dies nur über die öffentliche API erfolgen kann.
Unten sehen Sie einen Beispielaufruf mit der öffentlichen API, bei der nach Organisationsnamen gesucht wird ORCID, Vornamen, Familiennamen, aktueller Institutionszugehörigkeitsname und früherer Institutionszugehörigkeitsname als gewünschte Ausgabe.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:ORCID&fl=orcid,given-names,family-name,current-institution-affiliation-name,past-institution-affiliation-name
Unten sehen Sie einen weiteren Beispielaufruf, bei dem die öffentliche API verwendet wird, um nach verschiedenen Variationen des Organisationsnamens zu suchen.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:("University of Plymouth" OR "Plymouth University")
Wenn Sie glauben, dass die in Ihrem Bericht angezeigten Daten ungenau sind, dann bitte kontaktiere uns so detailliert wie möglich und unser Engagement-Team wird der Sache nachgehen.
ORCID wurde gegründet auf der Prinzip dass Forscher die Kontrolle über ihre Informationen haben sollten. Um diesem Grundsatz gerecht zu werden, haben wir eine starke Datenschutznestimmungen, das darauf ausgelegt ist, lokale Unterschiede in den Datenschutzbestimmungen zu berücksichtigen, und wir konzentrieren uns bei der Entwicklung von Richtlinien und Funktionen auf die Perspektive des Forschers.
Passend zu unserem Kernprinzip der Forscherkontrolle, ORCID Aufzeichnungen können nur von Forschern selbst erstellt werden ORCID Webseite.
Im Rahmen Ihres Integrationsworkflows können sich Ihre Forscher für ein neues registrieren ORCID iD oder melden Sie sich bei ihrem bestehenden Datensatz an, damit Sie ihre Authentifizierung abholen können ORCID Ausweis. Bitte sehen Sie sich unsere an API-Tutorials um mehr zu erfahren.
Wir freuen uns über Feedback aus unserer Community. Teilen Sie uns daher bitte mit, wenn Sie Feedback zu den Mitgliedsberichten haben, indem Sie uns unter kontaktieren https://support.orcid.org/hc/en-us/requests/new
Wenn Ihre Organisation eine ist ORCID Mitglied, dann müssen Sie sich an das wenden ORCID Wenden Sie sich an Ihre Organisation, die Ihnen Zugriff darauf gewähren kann ORCID Mitgliederportal. Wenn Sie Ihre Organisationen nicht identifizieren können ORCID Kontaktieren Sie dann bitte Ihren Konsortiumsleiter oder Ihren Engagement-Team-Vertreter.
Die Daten, die zur Erstellung der Mitglieder- und Integrationsberichte verwendet werden, werden täglich aktualisiert.
Alle Zugehörigkeitsabschnitte verwenden denselben Metadatensatz in der API:
- Name der Organisation:* Der Name der Organisation auf höchster Ebene (z. B. „Boston University“ statt „Boston University School of Medicine“).
- Organisationsort:* Stadt, in der die Organisation ihren Sitz hat.
- Organisationsregion: Region, in der die Organisation ihren Sitz hat.
- Organisationsland* das Land der Organisation. Dies sollte mit dem ausgefüllt werden zweibuchstabiger ISO 3166 Alpha-2-Ländercode.
- Organisations-ID (ROR, GRID, Ringgold** oder LEI):* Eine eindeutige Kennung für die Organisation und ihre Quelle. Wir empfehlen, innerhalb der Zugehörigkeit die ID der übergeordneten Organisation und nicht die der Abteilung oder Abteilung zu verwenden.
- Rolltitel: Die ausgeübte Position oder der verliehene oder zu verleihende Abschluss.
- Abteilung: Jede Unterteilung der Mutterorganisation.
- URL: Eine URL zu einer Ressource über die Zugehörigkeit
- Anfangsdatum: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation begann (kann bis auf Jahr, Monat und Tag genau angegeben werden).
- Endtermin: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation endete (kann bis auf Jahr, Monat und Tag genau angegeben werden)
- Eine externe dauerhafte Kennung, die die Zugehörigkeit beschreibt: Ein eindeutiger Bezeichner für die tatsächliche Zugehörigkeitsbehauptung
*Markiert eine notwendiges Feld.
**Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ for more info
Es gibt eine Reihe von Abschnitten unter dem Biografieteil einer ORCID Aufzeichnung:
Auch bekannt als: Dies kann einen abgekürzten Vornamen, Varianten einschließlich Initialen für einen oder mehrere Vornamen, Zweitnamen, frühere oder alternative Namen oder Namen in einem anderen Zeichensatz umfassen. Jeder Name sollte als einzelnes Element hinzugefügt werden. Dies ist ein Freitextfeld mit bis zu 255 Zeichen.
Webseiten: Dieser Abschnitt enthält eine Beschreibung (optional) und eine Website-URL (erforderlich).
Kanton: Der Abschnitt „Land“ eines ORCID Mit Record können Forscher und Mitgliedsorganisationen ein oder mehrere Länder hinzufügen, in denen sie forschen oder die Gegenstand ihrer Forschung sind. Die Elemente in der Länderliste stammen aus ISO 3166, dem internationalen Standard für Länder- und Regionscodes.
Externe Identifikatoren (andere IDs): Dieser Abschnitt kann nur von Mitgliedsorganisationen hinzugefügt werden. Bitte beachten Sie, dass viele Organisationen zwar andere externe Identifikatoren für ihre Forscher sammeln, z. B. Scopus-Autoren-IDs, diese jedoch nur vom Aussteller dieser Identifikatoren verbindlich geltend gemacht werden können. Wir empfehlen daher dringend, dass Ihre Organisation nur Identifikatoren hinzufügt, die Ihr(e) System(e) erstellt und zur Identifizierung von Forschern verwendet hat(en). Dieser Abschnitt enthält vier Komponenten (* kennzeichnet ein Pflichtfeld):
- ID-Typ*
- ID-Wert*
- ID-Beziehung*
- ID-URL
- Rolle:* Die Rolle der Person im Begutachtungsprozess, aus der ausgewählt werden kann: Vorsitzender, Herausgeber, Mitglied, Organisator, Gutachter
- Gruppenkennung:* Die Gruppen-ID, die für Aggregationszwecke verwendet wird – für Zeitschriftenartikel ist die Standardkennung die eISSN, die automatisch über eine Integration mit der ISSN-Datenbank ausgefüllt wird. Bitte beachten Sie: Wenn Sie eine andere Kennung als eine ISSN zuweisen müssen, müssen Sie Erstellen Sie es vorher.
- Einberufende Organisation*: Die Organisation, die die Begutachtung organisiert hat – ein Zeitschriftenverlag, ein Konferenzorganisator, eine Finanzierungsagentur, eine Fakultät usw
- Organisationskennung: Die dauerhafte Kennung für die einberufende Organisation. Wir unterstützen derzeit ROR, Ringgold**, GRID, LEI oder Crossref Funder Registry Identifier. Bitte beachten Sie: Dies ist kein Pflichtfeld, wir empfehlen Ihnen jedoch, diese Daten zu veröffentlichen, sofern Sie darüber verfügen.
- Bewertungsdaten:* Diese Daten beziehen sich auf die Bewertungsaktivität und nicht darauf, was überprüft wurde
- Typ: Die Art der Überprüfungsaktivität: Überprüfung oder Bewertung
- Datum: Das Datum, an dem die Überprüfung abgeschlossen wurde. Dies kann allgemein (2008) oder spezifisch (2010) sein.
- Bewertungskennung: Ein einzigartiges, vorzugsweise lösbares Kennzeichnung bereitgestellt von der Quelle der Bewertung selbst. Sofern die Rezension nicht öffentlich zugänglich ist, empfehlen wir, dass diese keine identifizierbaren Daten enthält, die auf den Gegenstand der Rezension zurückgeführt werden können
- Rezensions-URL: Ein Link zu einer Online-Darstellung der Rezension oder des Rezensionsdatensatzes
- Informationen zum Bewertungsthema: Was auch immer der Rezensent bewertet hat
- Betrefftyp: Die Art des besprochenen Artikels, z. B. Zeitschriftenartikel, Konferenzbeitrag
- Dies beinhaltet die Liste der Arbeitsarten UND die Liste der Förderarten („Zuschuss“, „Vertrag“, „Preis“, „Gehaltspreis“) UND Forschung-„Ressourcenvorschlag“ UND „undefiniert“
- Subjekt Name: Der Name des überprüften Artikels
- Externe Betreff-ID: Die eindeutige Kennung des Betreffs der Rezension, z. B. ein Artikel-DOI
- Name des Betreffcontainers: Der Name des Objekts, zu dem der Begutachtungsgegenstand gehört, z. B. die Konferenz, für die der Beitrag begutachtet wurde
- Betreff-URL: Die URL des Betreffs, der überprüft wurde
- Betrefftyp: Die Art des besprochenen Artikels, z. B. Zeitschriftenartikel, Konferenzbeitrag
* Zeigt ein Pflichtfeld an
**Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ for more info
Es gibt viele Arten von Forschungsressourcen, von Einwegreagenzien bis hin zu internationalen Kooperationen mit speziellen Einrichtungen. ORCID unterstützt ein High-Level-Modell, das für domänenspezifische Details auf andere Orte verweisen kann.
Es gibt vier übergeordnete Ressourcentypen:
Ressourcentyp | Definition | Beispiele |
Infrastruktur | Eine Einrichtung, ein Gebäude oder ein anderer physischer Raum, der zur Durchführung von Forschungsarbeiten genutzt wird | Neutronenspallationsquelle, Tieranlage, Datenenklave, archäologische Stätte, Teleskopanordnung. Schiffe, Flugzeuge, Bauernhöfe, Labore |
Sammlung | Ein Objekt oder eine Gruppe von Objekten, die zu Forschungszwecken verwendet werden; kann greifbar oder digital sein | Meeresmission, Feldkampagne, kollaborative Datensätze oder Ressourcen, Sammlung seltener Bücher; Museumssammlung, biologische Probensammlung |
Ausrüstung | Hardware für Forschungszwecke | Mikroskop, Computer, Glaswaren, Proben, Materialien |
Service | Für Forschungszwecke genutzte Dienste | Proteomik-Analyse, Computerdienstleistungen, Datenanalyse, logistische Unterstützung, juristische Dienstleistungen, Lektorat, Experten- oder Personalberatung |
Zusätzlich zum Ressourcentyp kann ein Forschungsressourcenelement innerhalb eines ORCID Der Datensatz enthält die folgenden Informationen. * kennzeichnet erforderliche Artikel
- Vorschlag/Registrierungstitel:* Dies ist das Hauptanzeigefeld für Forschungsressourcen, z. B. „Neutron Beam Award“ oder „Beam Time and Computing Resources“.
- Vorschlags-/Registrierungs-ID:* Dies ist die öffentliche Kennung (DOI, PURL usw.) für den Vorschlag oder die Anfrage zur Nutzung der Ressource. Idealerweise sollte diese Kennung dauerhaft sein und zu einer öffentlichen Zielseite mit Informationen über den Vorschlag oder die Anfrage führen, beispielsweise eine Auszeichnungsdatenbank oder ein Ressourcenbenutzerprotokoll.
- Gastgeber des Vorschlags:* Dies ist die Organisation, die Ressourcenvorschläge oder -anfragen entgegennimmt und bearbeitet. Der Vorschlagshost kann mit dem Ressourcenhost identisch sein
- ID der Aufnahmeorganisation des Vorschlags* Dies ist die öffentliche Kennung (eine von ROR, GRID, Open Funder ID, LEI) für die Organisation, die den Vorschlags- oder Anfrageprozess verwaltet
- Ressourcen):* (bis 100)
- Ressourcenname:* – zB „Neutronenspallationsquelle“
- Ressourcen-ID(s):* – aus einer erweiterbaren Liste akzeptabler PID-Typen (z. B. RRID, DOI, URI)
- Ressourcentyp:* – eine von „Infrastrukturen“, „Sammlungen“, „Ausrüstung“ oder „Dienste“
- Ressourcenhost(s):* Dabei handelt es sich um die Organisation, die die Ressource verwaltet oder betreibt, beispielsweise ein nationales Labor, eine Regierungsbehörde oder eine Forschungsuniversität
- ID der Ressourcenhostorganisation:* Dies ist die öffentliche Kennung (eine von ROR, GRID, Ringgold**, Open Funder ID, LEI) für die Organisation, die die Ressource hostet
- Angebots-URL: Ein Link zum Vorschlag
- Startdatum des Angebots: Das Datum, an dem der Zugriff begann
- Enddatum des Angebots: Das Datum, an dem der Zugriff endete oder enden wird
* Zeigt ein Pflichtfeld an
**Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ for more info
- Titel:* Der Titel der Arbeit
- Untertitel: Ein Untertitel zum Werk
- Übersetzter Titel: Der Titel, unter dem das Werk in einer anderen Sprache erscheint, die Sprache des übersetzten Titels wird als Attribut erfasst
- Zeitschriftentitel: Der Name einer größeren Sammlung, zu der das Werk gehört, beispielsweise „Journal“ für Zeitschriftenartikel oder „Book“ für Buchkapitel. Obwohl es sich um einen Zeitschriftentitel handelt, kann er für andere Werke verwendet werden
- Kurze Beschreibung: Eine kurze Beschreibung oder Zusammenfassung der Arbeit
- Zitattyp: Das Format, in dem das Zitat bereitgestellt wird. Dieses Feld wird aus einer Liste mit den folgenden Werten ausgewählt: APA, BIBTEX, CHICAGO, HARVARD, IEEE, MLA, RIS, UNSPECIFIED, VANCOUVER
- Zitatwert: Der Inhalt des Zitats
- Arbeitstyp: Die Art des Objekts, um das es sich bei der Arbeit handelt. Dieses Feld muss aus dem ausgewählt werden unterstützte Arbeitstypen
- Datum der Veröffentlichung: Das Datum, an dem das Werk veröffentlicht wurde. Wir empfehlen die Verwendung des frühesten Veröffentlichungsdatums
- Externer ID-Typ:* Der Typ der Kennung. Dieses Feld muss aus dem ausgewählt werden Unterstützte Werkkennungen
- Externer ID-Wert:* Der Bezeichner selbst
- Externe-ID-URL: Eine URL, in die der Bezeichner aufgelöst wird
- Externe-ID-Beziehung:* Kennungen, die nur für das hinzugefügte Werk gelten, werden als „Selbst“ gekennzeichnet. Bezeichner, die sich auf eine größere Sammlung beziehen, zu der dieses Werk gehört, werden auf „Teil davon“ gesetzt. Bezeichner, die für alternative Versionen des Werks gelten, werden auf „version-of“ gesetzt. Kennungen, die sich auf die Finanzierung der Arbeit beziehen, werden auf „gefördert durch“ gesetzt.
- Arbeits-URL: Eine URL, die auf die Arbeit verweist
- Mitwirkende: Informationen zu den Personen, die das Werk geschaffen haben
- Sprachcode: Die Sprache, die zur Beschreibung der Arbeit in den vorherigen Bereichen verwendet wird
- Kanton: Ein Land, in dem das Werk veröffentlicht wurde oder mit dem es anderweitig in Verbindung steht
* Zeigt ein Pflichtfeld an
Alle Zugehörigkeitsabschnitte verwenden denselben Metadatensatz in der API:
- Name der Organisation:* Der Name der Organisation auf höchster Ebene (z. B. „Boston University“ statt „Boston University School of Medicine“).
- Organisationsort:* Stadt, in der die Organisation ihren Sitz hat.
- Organisationsregion: Region, in der die Organisation ihren Sitz hat.
- Organisationsland* das Land der Organisation. Dies sollte mit dem ausgefüllt werden zweibuchstabiger ISO 3166 Alpha-2-Ländercode.
- Organisations-ID (ROR, GRID, Ringgold** oder LEI):* Eine eindeutige Kennung für die Organisation und ihre Quelle. Wir empfehlen, innerhalb der Zugehörigkeit die ID der übergeordneten Organisation und nicht die der Abteilung oder Abteilung zu verwenden.
- Rolltitel: Die ausgeübte Position oder der verliehene oder zu verleihende Abschluss.
- Abteilung: Jede Unterteilung der Mutterorganisation.
- URL: Eine URL zu einer Ressource über die Zugehörigkeit
- Anfangsdatum: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation begann (kann bis auf Jahr, Monat und Tag genau angegeben werden).
- Endtermin: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation endete (kann bis auf Jahr, Monat und Tag genau angegeben werden)
- Eine externe dauerhafte Kennung, die die Zugehörigkeit beschreibt: Ein eindeutiger Bezeichner für die tatsächliche Zugehörigkeitsbehauptung
*Markiert eine notwendiges Feld.
**Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ for more info
- Förderart:* Die Art der gewährten Finanzierung. Dieses Feld wird aus einer Liste ausgewählt, die die folgenden Werte enthält: Auszeichnung, Vertrag, Zuschuss, Gehaltszuschuss
- Fördertitel:* Der Titel des Finanzierungselements
- Untertitel: Ein Untertitel zum Finanzierungselement
- Übersetzter Titel: Der Titel, unter dem die Förderung in einer anderen Sprache erscheint, wird als Attribut in der Sprache des übersetzten Titels erfasst
- Beschreibung: Eine Beschreibung oder kurze Zusammenfassung des geförderten Projekts.
- Menge: Der Wert der Auszeichnung
- Eindeutige Finanzierungskennung: Fügen Sie so viele davon hinzu, wie Ihr System erkennt, da dies die Gruppierung erleichtert ORCID Records.
- Typ der Finanzierungskennung: Bewilligungsnummer, DOI, URI oder Vorschlags-ID verwenden
- Wert des Bezeichners
- Identifikations-URL (optional)
- Beziehung: Selbst/Teil-von
Damit soll die Beziehung des Finanzierungselements zum Identifikator angegeben werden. Wenn sich das Finanzierungselement beispielsweise auf eine Phase eines mehrteiligen Zuschusses bezieht und die Kennung für den mehrteiligen Zuschuss gilt, lautet die Beziehung „Teil von“; Wenn die Kennung für die einzelne Phase gilt, wäre die Beziehung „selbst“.
- Fördergeber (Organisation):* Informationen über die Organisation, die die Förderung vergeben hat
- Name der Agentur
- Adresse (Stadt und Land)
- Organisationskennung:
- Anfangsdatum: Das Datum, an dem die Finanzierung begann
- Endtermin: Das Datum, an dem die Finanzierung endete
- Informationen für Mitwirkende: Angaben zu den Personen, die die Förderung erhalten haben
- ORCID Ausweis: Der ORCID iD jedes Mitarbeiters des Förderprojekts; Dies sollte nur authentifiziert umfassen ORCID IDs
- Rolle: Die Art des Beitrags des Forschers
* Zeigt ein Pflichtfeld an
Alle Zugehörigkeitsabschnitte verwenden denselben Metadatensatz in der API:
- Name der Organisation:* Der Name der Organisation auf höchster Ebene (z. B. „Boston University“ statt „Boston University School of Medicine“).
- Organisationsort:* Stadt, in der die Organisation ihren Sitz hat.
- Organisationsregion: Region, in der die Organisation ihren Sitz hat.
- Organisationsland* das Land der Organisation. Dies sollte mit dem ausgefüllt werden zweibuchstabiger ISO 3166 Alpha-2-Ländercode.
- Organisations-ID (ROR, Ringgold**, GRID oder LEI):* Eine eindeutige Kennung für die Organisation und ihre Quelle. Wir empfehlen, innerhalb der Zugehörigkeit die ID der übergeordneten Organisation und nicht die der Abteilung oder Abteilung zu verwenden.
- Rolltitel: Die ausgeübte Position oder der verliehene oder zu verleihende Abschluss.
- Abteilung: Jede Unterteilung der Mutterorganisation.
- URL: Eine URL zu einer Ressource über die Zugehörigkeit
- Anfangsdatum: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation begann (kann bis auf Jahr, Monat und Tag genau angegeben werden).
- Endtermin: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation endete (kann bis auf Jahr, Monat und Tag genau angegeben werden)
- Eine externe dauerhafte Kennung, die die Zugehörigkeit beschreibt: Ein eindeutiger Bezeichner für die tatsächliche Zugehörigkeitsbehauptung
*Markiert eine notwendiges Feld.
**Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ for more info
Alle Zugehörigkeitsabschnitte verwenden denselben Metadatensatz in der API:
- Name der Organisation:* Der Name der Organisation auf höchster Ebene (z. B. „Boston University“ statt „Boston University School of Medicine“).
- Organisationsort:* Stadt, in der die Organisation ihren Sitz hat.
- Organisationsregion: Region, in der die Organisation ihren Sitz hat.
- Organisationsland* das Land der Organisation. Dies sollte mit dem ausgefüllt werden zweibuchstabiger ISO 3166 Alpha-2-Ländercode.
- Organisations-ID (ROR, GRID, RInggold** oder LEI):* Eine eindeutige Kennung für die Organisation und ihre Quelle. Wir empfehlen, innerhalb der Zugehörigkeit die ID der übergeordneten Organisation und nicht die der Abteilung oder Abteilung zu verwenden.
- Rolltitel: Die ausgeübte Position oder der verliehene oder zu verleihende Abschluss.
- Abteilung: Jede Unterteilung der Mutterorganisation.
- URL: Eine URL zu einer Ressource über die Zugehörigkeit
- Anfangsdatum: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation begann (kann bis auf Jahr, Monat und Tag genau angegeben werden).
- Endtermin: Das Datum, an dem die Beziehung zwischen dem Forscher und der Organisation endete (kann bis auf Jahr, Monat und Tag genau angegeben werden)
- Eine externe dauerhafte Kennung, die die Zugehörigkeit beschreibt: Ein eindeutiger Bezeichner für die tatsächliche Zugehörigkeitsbehauptung
*Markiert eine notwendiges Feld.
**Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ for more info
Funktioniert ORCID werden auf der Grundlage ihrer Identifikatoren und der Beziehung dieser Identifikatoren zum Werk gruppiert. Es gibt vier Arten von Beziehungen:
- Selbst: Die Kennung bezieht sich ausschließlich auf dieses Werk und kann mit anderen Werken gruppiert werden, die dieselbe Kennung haben
- Ein Teil: Das Werk ist Teil dieser Kennung und kann nicht mit anderen Werken gruppiert werden
- Version von: Diese Identifikatoren gelten für alternative Versionen des Werks und können mit Selbst- und Versions-Identifikatoren gruppiert werden
- Gefördert durch: Diese Kennungen gelten für die Finanzierung der Arbeit. Diese Kennungen werden nicht zur Gruppierung von Werken verwendet.
Unsere API bietet hierfür Unterstützung im XSD. Jedes Element hat ein Anzeigeindexattribut, das seinen Rang innerhalb seiner Gruppe angibt. Der höchste Anzeigeindex ist das vom Forscher ausgewählte bevorzugte Element. Über die API hinzugefügte Elemente, die vom Forscher nicht bewertet wurden, haben einen Anzeigeindex von 1 und werden als standardmäßig bevorzugte Quelle innerhalb der Gruppe verwendet, bis sie vom Forscher geändert werden. Der Anzeigeindex bestimmt auch die Arbeitsreihenfolge beim Lesen der ORCID Datensatz mit der API.
Weitere Informationen zur Gruppierung finden Sie unter ORCID Aufzeichnungen finden Sie in unserer Unterstützungsartikel.
An ORCID Der Datensatz kann Informationen über die Arbeit, Zugehörigkeiten, Finanzierung, Peer-Review und mehr eines Forschers enthalten.
Artikel an ORCID Datensätze können unterteilt werden in Behauptungen die verbinden die ORCID iD-Inhaber mit einer Tätigkeit oder Zugehörigkeit. Diese Behauptungen können zu einer hinzugefügt werden ORCID Aufzeichnung durch den Forscher, der Eigentümer der Aufzeichnung ist, oder durch Systeme, denen der Forscher die Erlaubnis dazu erteilt hat. Wir nennen die Entität, die eine Behauptung zu einem hinzugefügt hat ORCID Nehmen Sie die auf Quelle.
Beispiele
Gemäß unseren Grundsätzen der Transparenz und Offenheit halten wir es für wichtig, die Quelle der Behauptung sehen zu können – wer diese Informationen in die Akte einfügt. So machen wir das:
- Wenn ein Forscher (oder sein Beauftragter vertrauenswürdige Person) fügt ihrem Datensatz eine Behauptung hinzu, ORCID zeichnet diese Person automatisch als Quelle auf
- Wenn ein vom Forscher genehmigtes System eine Behauptung zu einem Datensatz hinzufügt, ORCID erfasst automatisch den Anlageneigentümer (an ORCID Mitglied) als Quelle.
Wir zeigen den Quellnamen in der Benutzeroberfläche an und stellen ihn (mit seiner eindeutigen Kennung) in der API zur Verfügung:
Arbeitsabläufe bei der Recherche von Informationen können jedoch komplizierter sein, und die wahre Quelle einer Behauptung kann unbeabsichtigt verschleiert werden, indem ein System ein Element im Namen einer Person oder ein anderes System hinzufügt. Um Transparenz zu gewährleisten, müssen wir unterscheiden, wer die Verbindung zwischen der Person und dem Element hergestellt hat und wer das Element zum Datensatz hinzugefügt hat. Wie oben: Wer auch immer das Element hinzufügt ORCID Rekord ist der Quelle; wer auch immer die Verbindung zwischen den herstellt ORCID iD und der Artikel ist der Ursprung der Behauptung.
Beispielsweise:
- Ein Forscher importiert Daten in sein ORCID Datensatz aus einem System, z. B. einem Such- und Verknüpfungsassistenten. Der Forscher stellt die Behauptung auf, sie zu verbinden iD mit dem Artikel, also sind sie das Ursprung der Behauptung; während das System die Entität ist, die die Behauptung zum hinzufügt ORCID Rekord – der Quelle
- Ein Forscher interagiert mit System A (dem Behauptung origin), das zur Aktualisierung die von System B bereitgestellten Dienste nutzt ORCID Aufzeichnungen, was System B zum macht Quelle
Wir ermutigen unsere Community, Schritte zu unternehmen, um Informationen über den Ursprung der Behauptung zu bewahren und weiterzugeben, damit jeder von der Einsicht in die Quelle profitieren kann.
Weitere Informationen finden Sie unter:
ORCID ermöglicht das Hinzufügen mehrerer Arten von Werken. Nachfolgend finden Sie eine Liste der derzeit unterstützten Arbeitstypen, die weitgehend mit dem CASRAI-Ausgabestandard übereinstimmt.
Publikationen
Arbeitstyp | Verwenden Sie die |
buchen | Bücher, die von einem einzelnen Autor oder in Zusammenarbeit geschrieben wurden und auf Forschungsergebnissen oder wissenschaftlichen Erkenntnissen basieren, die im Allgemeinen aus von Experten begutachteten Mitteln stammen. |
Buchkapitel | Texte, die von einem einzelnen Autor oder gemeinsam verfasst wurden und auf Forschung oder wissenschaftlichen Erkenntnissen und Fachwissen in einem Fachgebiet basieren. |
Buchrezension | Kritische Rezension von Werken der Belletristik oder Sachliteratur, wobei die Beiträge zu einer Kunst, einem Fachgebiet oder einer Disziplin hervorgehoben werden. |
Eintrag im Wörterbuch | Einträge neuer Wörter, neue Bedeutungen bestehender Wörter, Änderungen der Rechtschreibung und Silbentrennung über einen längeren Zeitraum sowie grammatikalische Änderungen. |
Dissertation | Abhandlung, die einen originellen, aus der Forschung hervorgegangenen Standpunkt vertritt: Voraussetzung für einen Doktorgrad. Dies ist nur mit API v2.x verfügbar |
Dissertation | Eine Arbeit, die in der Regel auf Originalforschung basiert und die Beherrschung des eigenen Fachs und der wissenschaftlichen Methode durch den Kandidaten nachweist. Dies ist nur mit API v3.0+ verfügbar |
Enzyklopädie-Eintrag | Verfasste Einträge in einem Nachschlagewerk oder einem Kompendium mit Schwerpunkt auf einem bestimmten Fachgebiet oder auf allen Wissensgebieten. |
bearbeitetes Buch | Bücher, die von einem einzelnen Autor oder gemeinsam zur Verbreitung von Forschungsergebnissen oder wissenschaftlichen Erkenntnissen herausgegeben wurden, die im Allgemeinen aus von Experten begutachteten Mitteln stammen. |
Zeitschriftenartikel | Artikel in peer-reviewten Veröffentlichungen, die die Ergebnisse origineller Forschung und Wissenschaft verbreiten. |
Zeitschriftenausgabe | Regelmäßige Veröffentlichungen zur Förderung der intellektuellen Debatte und Forschung. |
Magazin Artikel | Artikel in thematischen Publikationen, die in festgelegten Abständen veröffentlicht werden. |
manuell | Für Lehrzwecke erstellte Kurs- und Aufgabenmaterialien. |
Online-Ressource | Informationen, die nur über herkömmliche technische Methoden im Internet zugänglich sind |
Newsletter-Artikel | Artikel in Publikationen, die sich an Forscher, Entscheidungsträger, Fachleute und die Öffentlichkeit richten und über ein Forschungsprojekt oder über die Aktivitäten eines Forschungslehrstuhls oder eines Forschungszentrums berichten. |
Zeitungsartikel | Artikel in einer täglichen, wöchentlichen oder monatlichen Publikation, die über Nachrichten und gesellschaftliche Themen berichten und sich an die Öffentlichkeit richten. |
Preprint | Version eines Papiers, die vor der formellen Begutachtung und Veröffentlichung öffentlich zugänglich gemacht wird. Dies ist nur mit API v3.0+ verfügbar |
berichten | Berichte zur Verbreitung der Ergebnisse und Leistungen eines Forschungsauftrags. |
Überprüfen | Eine formelle Bewertung der Arbeit eines anderen. Dies ist nur mit API v3.0+ verfügbar |
Forschungs Werkzeug | Eine Reihe von Beobachtungen, Messungen oder Fakten, die sich aus der Forschung ergeben. |
betreute-studentische-publikation | Artikel über Forschungsergebnisse, die gemeinsam mit dem Betreuer der Abschlussarbeit veröffentlicht oder von ihm betreut werden. |
Test | Beurteilungen, die Tests umfassen, die für die allgemeine Universitätsauswahl, die Auswahl in bestimmte Kurse oder andere Bewertungszwecke konzipiert sind. |
Übersetzung | Übersetzungen von Büchern und Artikeln, die Änderungen an der Originalausgabe erkennen lassen, beispielsweise ein neues oder überarbeitetes Vorwort. |
Website | Eigenständige Orte im Web, an denen mehrere Arten von Informationen zu einem bestimmten Thema verfügbar sind. |
Arbeitspapier | Vorläufige Versionen von Artikeln, die keiner Überprüfung unterzogen wurden, aber zur Kommentierung geteilt werden können. |
Konferenz
Arbeitstyp | Verwenden Sie die |
Konferenz-Zusammenfassung | Texte einer bestimmten Länge, die das Thema angeben, das in einem vorgeschlagenen Konferenzpapier diskutiert werden soll. |
Konferenzpapier | Allein oder gemeinsam verfasste Aufsätze, die auf einer wissenschaftlichen Konferenz vorgestellt und im Tagungsband (nicht in Fachzeitschriften) veröffentlicht werden. |
Konferenzplakat | Poster, die im Rahmen einer Konferenz präsentiert werden und Forschungsschwerpunkte auf effiziente Weise durch überzeugende Grafiken vermitteln. |
Geistiges Eigentum
Arbeitstyp | Verwenden Sie die |
Bekanntgabe | Veröffentlichungen, die Erfindungen als Stand der Technik etablieren und dadurch andere daran hindern, dieselbe Erfindung oder dasselbe Konzept zu patentieren. |
Lizenz | Unterzeichnete Vereinbarungen zur Nutzung eines Teils des geistigen Eigentums wie eines Prozesses, Produkts, Daten oder einer Software. |
Patent | Eine Form des IP-Schutzes, die das ausschließliche gesetzliche Recht für Erfinder und Rechtsnachfolger festlegt, ihre Erfindungen, Produkte oder Verfahren für einen begrenzten Zeitraum zu nutzen und zu verwerten. |
eingetragenes Urheberrecht | Eingetragener Inhaber von Rechten im Rahmen eines Rechtssystems zur Förderung der Schaffung und des Zugangs zu künstlerischen, literarischen, musikalischen, dramatischen und anderen kreativen Werken. |
Warenzeichen | Marken wie ein Name, ein Wort, eine Phrase, ein Logo, ein Symbol, ein Design oder ein Bild eines Produkts oder einer Dienstleistung, die die Quelle angeben und das Recht einräumen, die Verwendung der Kennung zu kontrollieren. |
Andere
Arbeitstyp | Verwenden Sie die |
Anmerkung | Anmerkungen enthalten Kommentare oder Beschreibungen zu einer anderen Ressource. Dies ist nur mit API v3.0+ verfügbar |
künstlerische Darbietung | Sammlung von Informationsaufzeichnungen, die in Kombination eine vollständige und aktuelle Geschichte künstlerischer oder darstellerischer Leistungen darstellen, die aus der Forschung oder wissenschaftlichen Tätigkeit der Person resultieren oder damit in Zusammenhang stehen. |
Datenverwaltungsplan | Eine formelle Erklärung, die beschreibt, wie Forschungsdaten während eines Forschungsprojekts verwaltet und dokumentiert werden und welche Bedingungen für die anschließende Hinterlegung der Daten in einem Datenspeicher zur langfristigen Verwaltung und Aufbewahrung gelten. Dies ist nur mit API v3.0+ verfügbar |
Datensatz | Eine Reihe strukturierter Beobachtungen, Messungen oder aus der Forschung ermittelter Fakten, die in einem Datenbankmedium gespeichert werden können. |
Erfindung | Praktische und originelle Ergebnisse aus der Forschung. |
Vortrag-Rede | Ein informativer Vortrag zum Thema Forschung vor einem Publikum. |
physikalisches Objekt | Eine Probe, Probe oder ein anderes physisches Objekt, das zu Forschungszwecken verwendet wird; ein unbelebtes dreidimensionales Objekt oder eine unbelebte Substanz. Dies ist nur mit API v3.0+ verfügbar |
Forschungstechnik | Eine praktische Methode oder Fertigkeit, die auf bestimmte Aufgaben angewendet wird, die im Rahmen der Forschung identifiziert wurden. |
Software. | Ein Programm zum Betrieb eines Computers oder eines anderen technischen Geräts. |
Spin-off-Unternehmen | Ein von einer Forschungsorganisation gegründetes Unternehmen, um die Ergebnisse und Erkenntnisse des Forschungsprojekts kommerziell zu nutzen. |
Standards und Richtlinien | Die Entwicklung einer Regel oder eines Prinzips, das als Grundlage für die Beurteilung dient. |
technischer Standard | Technische Standards (industriell oder anderweitig), die aus Forschungsprojekten entstanden sind, in denen neue Protokolle, Methoden oder Materialien entwickelt werden können. |
mehr | Jede andere Art von Arbeit. |
ORCID unterstützt die Verwendung von ROR-Kennungen, GRID-Bezeichner und dem Crossref-Förderregister Identifikatoren zur eindeutigen Unterscheidung von Organisationen ORCID Records.
Für weitere Informationen, siehe Arbeiten mit Organisationskennungen
Obwohl Ringgold-Identifikatoren immer noch innerhalb der existieren ORCID Register, ab 1. August 2023, ORCID erhält keine Aktualisierungen der von unserem Register verwendeten RINGGOLD-Organisationsidentifikationsdatenbank mehr und wir können auch nach diesem Datum erstellte RINGGOLD-IDs nicht mehr verarbeiten oder nutzen. Sehen Sie sich unsere an FAQ für weitere Infos
Bitte beachten Sie unsere Liste der unterstützten Bezeichner für die V3.0-API. Auf Wunsch fügen wir gelegentlich neue Typen hinzu ORCID Mitglieder, die sie beim Hinzufügen von Elementen zur Registrierung verwenden möchten.
- Vorname
- Zusätzliche
Rollen für Works API 2.0
Nachfolgend finden Sie die Liste der unterstützten Mitwirkendenrollen, die API 2.0 verwenden.- Autor
- Rechtsnachfolger
- Herausgeber
- Vorsitzender oder Übersetzer
- Co-Ermittler
- Miterfinder
- Doktorand
- anderer-Erfinder
- Hauptermittler
- Postdoktorand-Forscher
- Support-Mitarbeiter
Rollen für Works API 3.0
Mit API 3.0 können Sie die oben genannten Rollen sowie zusätzliche CRedIT-Rollen hinzufügen. Die CRediT-Taxonomie besteht aus 14 Beitragsarten zur wissenschaftlichen Arbeit, zusammen mit Richtlinien, wie diese Rollen zugewiesen werden können. Nachfolgend finden Sie die vollständige Liste mit dem UI-Wert und dem Metadatenwert. Der Metadatenwert ist die URL gemäß den NISO-Implementierungsempfehlungen.CRediT sollte in JATS XML v1.2 codiert werden, beschrieben über diesen Link: https://jats4r.org/credit-taxonomy.' Beim Hinzufügen von Rollen über die API wird nur die URL akzeptiert.Beispiel für Metadaten von Arbeitsmitarbeitern:
https://orcid.org/0000-0001-5109-3700 0000-0001-5109-3700 orcid.org Laure L. Haak first author
Rollen für die Finanzierung
- führen
- Co-Leiter
- unterstützt durch
- Anderer Beitrag
Wir haben ein neues, vom System generiertes Feld eingeführt, das externe Kennungen (DOIs, PMCID, PMID, ArXiv, Bibcode, ISSNs und ISBNs) zum Zweck des Abgleichs und der Gruppierung in einem normalisierten Format ausdrückt. Die Normalisierung erfolgt auf der Grundlage der Regeln des Bezeichnertyps und kann das Festlegen aller Alphazeichen in Kleinbuchstaben oder das Umwandeln von Leerzeichen, Bindestrichen, Punkten und anderen Zeichen umfassen, die als gleichwertig behandelt werden können. Außerdem werden gegebenenfalls Standardpräfixe und -suffixe hinzugefügt. Zum Beispiel, https://doi.org/10.1/123, 10.1/123 und https://dx.doi.org/10.1/123 werden alle in diesem Feld als angezeigt https://doi.org/10.1/123. Der vorhandene Bezeichnerwert bleibt unverändert.
Jeder Autor, dessen Verlag Crossref für die DOI-Registrierung verwendet, kann von der automatischen Update-Integration von Crossref profitieren.
Herausgeber müssen die authentifizierte Datei angeben ORCID IDs für ihre Autoren in den Metadaten, die bei der DOI-Registrierung an Crossref gesendet werden.
Crossref wird dann den Autor per Benachrichtigung an ihn um Erlaubnis bitten ORCID Posteingang, um ihre zu aktualisieren ORCID mit dieser Veröffentlichung und allen neuen Veröffentlichungen eines Verlags aufzeichnen.
Weitere Informationen finden Sie unter: https://www.crossref.org/community/orcid/
ORCID bietet ein Freitext-Zitatfeld, damit Forscher Informationen einfach im Textformat eingeben können. Wir empfehlen jedoch allen API-Benutzern dringend, Zitate in BibTeX hinzuzufügen, das maschinenlesbar ist. Das ehrwürdige Format kann, obwohl es vor dem Internet existiert, durch Integrationen und Autoren in das gewünschte Format umgewandelt werden. Es wird von den meisten Referenzmanagern und Veröffentlichungsplattformen unterstützt
Weitere Informationen zu BibTeX finden Sie unter https://www.bibtex.org.
Als Vorteil von ORCID Mitgliedschaft können Organisationen erfragen ORCID um zusätzliche PID-Typen im zu unterstützen ORCID Registrierung. Beispielsweise könnte ein Mitglied verlangen, dass wir Unterstützung für die PIDs hinzufügen, die es zur Identifizierung von Proben oder Datensätzen in seiner Geologiedatenbank verwendet. Dies ermöglicht Verbindungen zwischen den Proben und den Personen, die sie gesammelt haben. Und da alle neuen PID-Typen, die wir hinzufügen, mindestens auflösbar und vorzugsweise FAIR sein müssen, sind diese Verknüpfungen eindeutig, dauerhaft und umsetzbar – was dem Forscher, der Mitgliedsorganisation und der breiteren Gemeinschaft zugute kommt.
Hinzufügen Ihrer PID!
Als Gemeinschaftsorganisation wollen wir das sicherstellen ORCID unterstützt die von unseren Mitgliedern verwendeten PIDs. Wir pflegen eine vollständige Liste der vorhandenen Bezeichner, die in der Registry unterstützt werden und einladen ORCID Mitglieder zu verwenden kannst du dich über dieses Formular um zusätzliche PIDs anzufordern. Wir sind bestrebt, Ihre Anfrage so schnell wie möglich zu beantworten.
Jedes Element in der ORCID iD wird ein Put-Code zugewiesen, der es eindeutig identifiziert. Beim Lesen eines gesamten Datensatzes oder Abschnitts kann der Put-Code als Attribut des Elements gefunden werden. Wenn Aufrufen eines bestimmten Elements in einem Datensatz, wird der Put-Code zur Identifizierung des Artikels verwendet. Put-Codes sind innerhalb des Artikeltyps, auf den sie sich beziehen, eindeutig. Anhand dieses Beispiels funktioniert nur eine Arbeit in der ORCID Das Register hat den Put-Code 733535, obwohl 733535 auch als Put-Code für einen Finanzierungsartikel oder ein Schlüsselwort verwendet werden kann
Gesamtzahl der eindeutigen IDs: Die Anzahl der Forscher, die einer Integration Ihrer Organisation die Erlaubnis erteilt haben. Dazu gehören schreibgeschützte Berechtigungen und Aktualisierungsberechtigungen. Jeder Forscher wird nur einmal gezählt, unabhängig davon, mit wie vielen Integrationen er sich verbunden hat.
Ihre Integrationen: Eine Liste der Integrationen für Ihre Organisation, die die Mitglieder-API verwenden, mit der dazugehörigen Anzahl der verbundenen iDs und aktualisierten Datensätze. Außerdem ist der Name des Drittanbietersystems enthalten, das für die Integration verwendet wird ORCID wo anwendbar.
Neue Benutzer pro Jahr: Ein Diagramm, das die Benutzer zeigt, die sich im Laufe der Zeit mit jeder Ihrer Integrationen verbinden.
Die älteren Berichte, die wir vor 2022 unterstützt haben, stehen Ihnen nicht mehr zur Ansicht zur Verfügung. Wenn Sie Fragen zu den vorherigen Berichten haben, wenden Sie sich bitte an [E-Mail geschützt]
ORCID hat einen separaten Abschnitt in der ORCID Record zum Aufzeichnen von Informationen zu Qualifikationen, Akkreditierungen, Zertifikaten und Abzeichen.
Jedes Qualifikationselement enthält immer:
- Der Qualifikationstitel
- Die Organisations-ID des Anbieters (z. B. ROR-ID)
- Das Datum, an dem es hinzugefügt wurde ORCID Rekord
- Wer hat die Qualifikation hinzugefügt (die Quelle)?
Sie können enthalten:
- Das Gültigkeitsdatum, einschließlich eines Enddatums, falls die Qualifikation abläuft
- Die persistente Qualifikations-ID, die die Art der erworbenen Qualifikation identifiziert.
- Die Qualifikations-URL, die eine für Menschen lesbare Beschreibung der Art der erworbenen Qualifikation enthält.
- Die dauerhafte ID der Qualifikation. Diese sollte auf eine Online-Version des Qualifikationszertifikats verweisen. Dies kann eine vorhandene eindeutige ID oder einfach eine URI sein.
Aktualisierte Datensätze mit Zugehörigkeiten: Eine Metrik, die zählt, wie viele IDs durch Ihre Integrationen mit einem bestimmten Artikeltyp, z. B. Werken, Zugehörigkeiten, aktualisiert wurden
Insgesamt hinzugefügte Zugehörigkeiten: Eine Metrik, die zählt, wie viele eines bestimmten Artikels hinzugefügt wurden
Arten von Zugehörigkeiten hinzugefügt: Ein Prozentsatz, wie viele von jedem Zugehörigkeitstyp hinzugefügt wurden, z. B. Beschäftigung, Bildung
Hinzugefügte Organisationskennungen: Eine Tabelle mit den Zugehörigkeitstypen und Organisations-IDs, die von Ihrer Integration beim Hinzufügen von Zugehörigkeiten zu Datensätzen verwendet werden, zusammen mit der Anzahl der Datensätze, die mit dieser Organisations-ID aktualisiert wurden.
Gesamtzahl der aktualisierten Datensätze: Die Anzahl der Forscher, die von automatischen Aktualisierungen ihrer Datensätze durch Ihre Integrationen profitiert haben
Eindeutige verbundene iDs pro Jahr: Eine Grafik, die Connected iDs aufgeschlüsselt nach Jahr zeigt.
Pro Jahr durch Integration aktualisierte Datensätze: Die Anzahl der Forscher, die von automatischen Aktualisierungen ihrer Datensätze durch Ihre Integrationen profitiert haben
Gesamtzahl der pro Jahr durch Integration hinzugefügten Artikel: Ein Diagramm, das die Anzahl der Elemente zeigt, die jedes Jahr durch Ihre Integrationen hinzugefügt werden
Mit Werken aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens ein Werk hinzugefügt wurde
Insgesamt hinzugefügte Werke: Die Gesamtzahl der durch Ihre Integrationen hinzugefügten Werke
Arten von hinzugefügten Werken: Ein Prozentsatz, wie viele von jedem Arbeitstyp hinzugefügt wurden, z. B. Zeitschriftenartikel, Vorabdruck
Durch Peer-Review aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Peer-Review hinzugefügt wurde
Gesamte Peer-Review hinzugefügt: Die Gesamtzahl der durch Ihre Integrationen hinzugefügten Peer-Reviews
Mit Websites und sozialen Links aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Website und ein sozialer Link hinzugefügt wurden
Mit persönlichen Identifikatoren aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine persönliche Kennung hinzugefügt wurde
Aufzeichnungen mit Finanzierung aktualisiert: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Finanzierung hinzugefügt wurde
Gesamtfinanzierung hinzugefügt: Die Gesamtzahl der durch Ihre Integrationen hinzugefügten Mittel
Mit Forschungsressourcen aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Forschungsressource hinzugefügt wurde
Zugehörigkeitsländer: Ein Diagramm, das die Ländercodes in den Zugehörigkeitsmetadaten von Connected IDs zeigt.
Aktuelle Zugehörigkeiten: Eine Tabelle mit den Zugehörigkeiten aller IDs mit Ländercode, aufgeschlüsselt nach Organisations-ID und -Typ. Enthält nur aktuelle Zugehörigkeiten, also solche ohne Enddatum.
Ländercode: Ein Diagramm, das die Ländercodes zeigt, die in den biografischen Metadaten von Connected IDs eingeschränkt sind.
Benutzerstandort im letzten Jahr: Ein Diagramm, das zeigt, wo sich Ihr Benutzer befand, als er Ihrer Organisation über OAuth die Berechtigung erteilte
Gesamteinträge mit Domains: Eine Metrik, die die Gesamtzahl der iDs zählt, deren E-Mail-Adresse auf eine der registrierten Domänen endet. Wenn der Datensatz eine E-Mail-Adresse mit mehr als einer der registrierten Domänen enthält, werden diese mehr als einmal in die Zählung einbezogen. Wenn Sie weitere Domains hinzufügen möchten, teilen Sie uns dies bitte mit.
Datensätze mit registrierten Domains: Eine Liste Ihrer registrierten E-Mail-Domänen zusammen mit der Anzahl der Datensätze, die diese Domäne verwenden.
Datensätze nach Subdomain: Eine Liste Ihrer registrierten E-Mail-Subdomains zusammen mit der Anzahl der Datensätze, die diese Subdomain verwenden
Aufzeichnungen über das Hinzufügen von E-Mail-Domänen pro Jahr: Eine Grafik, die die Nutzung registrierter Domains im Zeitverlauf zeigt. Forscher haben möglicherweise mehr als eine E-Mail-Adresse registriert und in dieser Grafik werden alle Adressen des Forschers gezählt.
In diesem Abschnitt wird die Anzahl der Datensätze angezeigt, die Ihre Integrationen aktualisiert haben
Aktualisierte Datensätze mit Zugehörigkeiten: Eine Metrik, die zählt, wie viele iDs durch Ihre Integrationen mit Zugehörigkeiten aktualisiert wurden.
Gesamtzahl der hinzugefügten Zugehörigkeiten: Eine Metrik, die zählt, wie viele Zugehörigkeiten hinzugefügt wurden
Zugehörigkeitsarten hinzugefügt: Ein Prozentsatz, wie viele von jedem Zugehörigkeitstyp hinzugefügt wurden, z. B. Beschäftigung, Bildung
Hinzugefügte Organisationskennungen: Eine Tabelle mit den Zugehörigkeitstypen und Organisations-IDs, die von Ihrer Integration beim Hinzufügen von Zugehörigkeiten zu Datensätzen verwendet werden, zusammen mit der Anzahl der Datensätze, die mit dieser Organisations-ID aktualisiert wurden.
Mit Werken aktualisierte Datensätze: Eine Metrik, die zählt, wie viele iDs durch Ihre Integrationen mit Werken aktualisiert wurden
Insgesamt hinzugefügte Werke: Eine Metrik, die zählt, wie viele Werke hinzugefügt wurden
Hinzugefügte Arbeitsarten: Ein Prozentsatz, wie viele von jedem Arbeitstyp hinzugefügt wurden, z. B. Zeitschriftenartikel, Vorabdruck
Durch Peer-Reviews aktualisierte Datensätze: Eine Metrik, die zählt, wie viele Datensätze durch Ihre Integrationen mit einer Peer-Review aktualisiert wurden
Insgesamt hinzugefügte Peer-Reviews: Eine Kennzahl, die zählt, wie viele Peer-Reviews hinzugefügt wurden
Aufzeichnungen mit Finanzierung aktualisiert: Eine Metrik, die zählt, wie viele Datensätze durch Ihre Integrationen mit einer Finanzierung aktualisiert wurden
Gesamtfinanzierung hinzugefügt: Eine Metrik, die zählt, wie viele Mittel hinzugefügt wurden
Mit einer persönlichen Kennung aktualisierte Datensätze: Eine Metrik, die zählt, wie viele Datensätze durch Ihre Integrationen mit einer persönlichen Kennung aktualisiert wurden
Mit Forschungsressourcen aktualisierte Datensätze: Eine Metrik, die zählt, wie viele Datensätze durch Ihre Integrationen mit Forschungsressourcen aktualisiert wurden
Mit Websites und sozialen Links aktualisierte Datensätze: Eine Metrik, die zählt, wie viele Datensätze durch Ihre Integrationen mit einer Website oder einem sozialen Link aktualisiert wurden
In diesem Abschnitt wird die Anzahl der Forscher angezeigt, die mit Ihren Integrationen interagieren.
Vernetzte IDs: Die Anzahl der Forscher, die einer Integration Ihrer Organisation die Erlaubnis erteilt haben. Dazu gehören schreibgeschützte Berechtigungen und Aktualisierungsberechtigungen. Jeder Forscher wird nur einmal gezählt, unabhängig davon, mit wie vielen Integrationen er sich verbunden hat.
Verbundene IDs: Liste der verbundenen ORCID IDs einschließlich Datensatzname.
Mit dieser Integration aktualisierte Datensätze: Die Anzahl der Forscher, die von automatischen Aktualisierungen ihrer Datensätze durch Ihre Integrationen profitiert haben
iDs zuerst verbunden: Ein Diagramm, das Connected iDs im Zeitverlauf zeigt.
Datensätze zuerst aktualisiert: Ein Diagramm, das die im Laufe der Zeit aktualisierten Datensätze zeigt. Jede iD werden einmalig gezählt, entsprechend dem Jahr, in dem sie erstmals aktualisiert wurden
Pro Jahr verbundene einzigartige IDs: Eine Grafik, die Connected iDs aufgeschlüsselt nach Jahr zeigt.
Einzigartige Datensätze, die pro Jahr aktualisiert werden: Eine Grafik, die die aktualisierten Datensätze nach Jahr aufgeschlüsselt zeigt.¬¨‚
Dieser Abschnitt zeigt, wie viele Forscher mit dem Konsortialland verbunden sind. Dies wird vor allem für nationale Konsortien relevant sein. Beachten Sie, dass die angezeigten Informationen möglicherweise von Konsortialmitgliedern hinzugefügt wurden oder nicht.
Konsortialland: Ländercode Ihres Konsortiums
Gesamtzahl der mit dem Land verbundenen IDs: Eine Metrik, die die Gesamtzahl der iDs im Register angibt, die im Zugehörigkeitsabschnitt ihres Datensatzes den Ländercode des Konsortiums aufweisen. Beinhaltet alle Zugehörigkeiten, früher und heute
IDs mit Ländercode: Eine Metrik, die die Gesamtzahl der iDs im Register angibt, die im Biografieabschnitt ihres Datensatzes den Ländercode des Konsortiums aufweisen.
Gesamtzahl der mit dem Land verbundenen IDs (aktuell): Eine Metrik, die die Gesamtzahl der iDs im Register angibt, die im Zugehörigkeitsabschnitt ihres Datensatzes den Ländercode des Konsortiums aufweisen. Berücksichtigt werden nur aktuelle Zugehörigkeiten, also solche ohne Enddatum.
Aktuelle Zugehörigkeiten (für alle iDs mit Land):Eine Tabelle mit den auf allen gefundenen Zugehörigkeiten IDs mit Ländercode, aufgeschlüsselt nach Organisations-ID und -Typ. Enthält nur aktuelle Zugehörigkeiten, also solche ohne Enddatum.
Aktive IDs mit Ländercode: Anzahl der aktiven Datensätze (angemeldet oder Datensatz innerhalb der letzten 365 Tage aktualisiert) mit Ländercode des Konsortiums
In diesem Abschnitt wird die Anzahl der Forscherdatensätze angezeigt, die von Konsortialmitgliederintegrationen aktualisiert wurden. Es kann verwendet werden, um zu verstehen, wie gut Konsortialmitglieder ihre Forscher dabei unterstützen, ihre Aufzeichnungen auf dem neuesten Stand zu halten.
Einzigartige Datensätze, die pro Jahr aktualisiert werden: Ein Diagramm, das die aktualisierten Datensätze nach Jahr aufgeschlüsselt zeigt. Forscher werden für alle Jahre gezählt, in denen sie von einem Konsortialmitglied aktualisiert wurden.
Pro Jahr verbundene einzigartige IDs: Eine Grafik, die Connected iDs aufgeschlüsselt nach Jahr zeigt. Gezählt werden die Forscher für alle Jahre, in denen sie die Erlaubnis erteilt haben.
Pro Jahr durch Integration aktualisierte Datensätze: Ein Diagramm mit den aktualisierten Datensätzen, aufgeschlüsselt nach Jahr und Integration innerhalb Ihrer Konsortien
Dieser Abschnitt zeigt die Anzahl der Forscher, die mit der Integration von Konsortialmitgliedern interagieren.
Gesamtzahl der Konsortialmitglieder: Die Gesamtzahl der Mitglieder Ihres Konsortiums
Gesamtintegrationen: Die Gesamtzahl der Integrationen in Ihrem Konsortium
Aktive Integrationen: Die Anzahl der Integrationen in Ihren Konsortien, die mindestens einen Datensatz aktualisiert haben
Insgesamt verbundene IDs: Die Anzahl der Forscher, die einem zum Konsortium gehörenden Mitglied die Integrationsgenehmigung erteilt haben. Dazu gehören schreibgeschützte Berechtigungen und Aktualisierungsberechtigungen. Jeder Forscher wird nur einmal gezählt, unabhängig davon, mit wie vielen Integrationen er sich verbunden hat
Aufzeichnungen aktualisiert
Die Anzahl der Forscher, die von automatischen Aktualisierungen ihrer Aufzeichnungen durch Mitglieder von Konsortien profitiert haben.
Integration von Konsortialmitgliedern:
Eine Liste der von den Mitgliedern des Konsortiums registrierten Integrationen mit der zugehörigen Anzahl der Connected iDs, aktualisierten Datensätzen, dem ggf. verwendeten Dienstanbietersystem und der Frage, ob die Integration für das Mitgliederportal bestimmt ist (Affiliation Manager)
Neue Benutzer pro Jahr durch Integration: Ein Diagramm, das die Benutzer zeigt, die sich im Laufe der Zeit mit jeder Ihrer Integrationen verbinden.
Dieser Abschnitt zeigt, woher die verbundenen IDs stammen
Aktuelle Zugehörigkeitsländer: Ein Diagramm, das die Ländercodes in den Zugehörigkeitsmetadaten von zeigt Verbundene IDs.
Aktuelle Zugehörigkeiten: Eine Tabelle mit den Zugehörigkeiten aller IDs mit Ländercode, aufgeschlüsselt nach Organisations-ID und -Typ. Enthält nur aktuelle Zugehörigkeiten, also solche ohne Enddatum.
Benutzerstandort: Ein Diagramm, das zeigt, wo sich Ihr Benutzer befand, als er Ihrer Organisation über OAuth die Berechtigung erteilte
Ländercode: Ein Diagramm, das die Ländercodes zeigt, die in den biografischen Metadaten von Connected IDs eingeschränkt sind.
Aktualisierte Datensätze mit Zugehörigkeiten: Eine Metrik, die zählt, wie viele iDs durch die Integration von Konsortialmitgliedern mit einer Zugehörigkeit aktualisiert wurden
Zugehörigkeitsarten hinzugefügt: Ein Prozentsatz, wie viele von jedem Zugehörigkeitstyp hinzugefügt wurden.
Insgesamt hinzugefügte Zugehörigkeiten: Eine Metrik, die zählt, wie viele Zugehörigkeiten durch die Integration von Konsortialmitgliedern hinzugefügt wurden
Konsortialmitglieder fügen Zugehörigkeiten hinzu: Eine Liste, wie viele Zugehörigkeiten durch die Integration von Konsortialmitgliedern hinzugefügt wurden
Hinzugefügte Organisationskennungen:Eine Liste, wie viele Organisationskennungen durch die Integration von Konsortialmitgliedern hinzugefügt wurden.
In diesem Abschnitt wird angezeigt, wie viele Forscher sich über die E-Mail-Domäne(n) registriert haben, bei denen sich die Konsortien registriert haben ORCID. Es können maximal fünf E-Mail-Adressen registriert werden.
Nationale E-Mail-Domäne: Was ORCID verfügt über eine nationale E-Mail-Domäne für Ihr Land
Datensätze mit nationaler Domain: Eine Anzahl von Datensätzen, die eine E-Mail-Adresse mit Ihrer nationalen E-Mail-Domäne haben
Von Mitgliedern registrierte E-Mail-Domänen: Eine Liste der E-Mail-Domänen, die von Ihren Konsortiumsmitgliedern registriert wurden
Datensätze nach Mitgliedssubdomain: Eine Liste der Subdomains, die mit Ihren Konsortien verbunden sind, und deren Anzahl ORCID Datensätze sind mit ihnen verknüpft. Bitte beachten Sie, dass diese Anzahl an Datensätzen möglicherweise nicht mit der Gesamtzahl der Datensätze Ihrer E-Mail-Domain übereinstimmt. Dies könnte daran liegen, dass nicht alle für Ihre Konsortialmitglieder registrierten E-Mail-Domänen in Ihrer nationalen Domäne enden
Aktive Datensätze mit nationaler Domain: Anzahl der aktiven Datensätze (Anmeldung oder Datensatz innerhalb der letzten 365 Tage aktualisiert) mit nationaler E-Mail-Domäne
Aufzeichnungen über das Hinzufügen von E-Mail-Domains pro Jahr: Ein Diagramm, das die Anzahl der hinzugefügten Datensätze pro E-Mail-Domäne zeigt.
Pro Jahr durch Integration hinzugefügte Artikel:Ein Diagramm, das zeigt, wie viele Elemente nach Jahr und Mitglied in Ihren Konsortien hinzugefügt wurden.
Mit Werken aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens ein Werk hinzugefügt wurde
Insgesamt hinzugefügte Werke: Die Gesamtzahl der durch Ihre Integrationen hinzugefügten Werke
Hinzugefügte Arbeitsarten: Ein Prozentsatz, wie viele von jedem Arbeitstyp hinzugefügt wurden, z. B. Zeitschriftenartikel, Vorabdruck
Durch Peer-Reviews aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Peer-Review hinzugefügt wurde
Insgesamt hinzugefügte Peer-Reviews: Die Gesamtzahl der durch Ihre Integrationen hinzugefügten Peer-Reviews
Aufzeichnungen mit Finanzierung aktualisiert: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Finanzierung hinzugefügt wurde
Gesamtfinanzierung hinzugefügt: Die Gesamtzahl der durch Ihre Integrationen hinzugefügten Mittel
Mit Forschungsressourcen aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Forschungsressource hinzugefügt wurde
Mit Websites und sozialen Links aktualisierte Datensätze:Die Anzahl der Datensätze, denen durch eine Integration mindestens eine Website und ein sozialer Link hinzugefügt wurden
Mit persönlichen Identifikatoren aktualisierte Datensätze: Die Anzahl der Datensätze, denen durch eine Integration mindestens eine persönliche Kennung hinzugefügt wurde
Du kannst dich Fordern Sie Anmeldeinformationen für die Sandbox-Mitglieds-API an um Ihre Anwendung zu erstellen und zu testen. Mit diesen Anmeldeinformationen können Sie Aufrufe an die Sandbox-Premium-Mitglieds-API tätigen, um zu lesen, zu schreiben und zu aktualisieren ORCID Aufzeichnungen. Der Zugriff auf die Sandbox-Testumgebung steht jedem frei zur Verfügung, auch wenn Sie kein Benutzer sind ORCID Mitgliedsorganisation.
Note: Wenn Sie eine verwenden ORCID zertifiziertes Service-Provider-System, das bereits ORCIDmüssen Sie sich nicht für Sandbox-API-Anmeldeinformationen registrieren, es sei denn, Sie möchten die ORCID Integrationsfunktionalität innerhalb der Sandbox-Umgebung.
Mit der Sandbox können Sie Testbenutzerkonten erstellen und Ihre Integration entwickeln, ohne sich Gedanken über die Beeinträchtigung der Live-Daten (Produktion) machen zu müssen. ORCID Registrierung. Die Sandbox verhält sich genauso wie die Produktion ORCID Registrierung bei ein paar Ausnahmen.
Erstellen eines Testkontos
Um das zu testen ORCID API und API-Aufrufe, z. B. das Lesen und Hinzufügen von Informationen zu einem ORCID Um den Datensatz aufzuzeichnen, müssen Sie auch einen Test erstellen ORCID Aufnahme in die Sandbox. Dies kann über die Benutzeroberfläche erfolgen, ähnlich wie in der Produktion ORCID Registrierung. Gehe zu https://sandbox.orcid.org/register und registrieren Sie sich für ein Konto.
Mailinator-E-Mail-Adressen
Der Sandbox-Server sendet E-Mails nur an Mailinator (@mailinator.com) E-Mail-Adressen, um Mailserver nicht unbeabsichtigt zu spammen. Sie erhalten keine Verifizierungs-E-Mail oder Benachrichtigung zum Zurücksetzen des Passworts, es sei denn, Sie verwenden eine @mailinator.com-Adresse und eine Verifizierung ist erforderlich, um manuelle Änderungen an Sandbox-Datensätzen vorzunehmen. Erfahren Sie mehr über die kostenlosen öffentlichen Posteingänge . Wenn Sie a nicht verwenden möchten Mailinator Bitte notieren Sie sich dann Ihren Benutzernamen und Ihr Passwort (da Sie diese beim Testen zur Autorisierung Ihrer Anwendung verwenden) und kontaktieren Sie uns, um Unterstützung bei der Verifizierung anzufordern.
Mailinator ist ein E-Mail-Dienst, der über einen öffentlichen kostenlosen Dienst und einen privaten kostenpflichtigen Dienst verfügt. Zum Testen können Sie den völlig kostenlosen öffentlichen Dienst nutzen. Erfahren Sie mehr über ihre Stufen Hier .
Mailinator ist ein Drittanbieterdienst, der nicht von verwaltet oder gewartet wird ORCID. Wir empfehlen Ihnen, die Funktionsweise dieses Dienstes und seine Einschränkungen zu prüfen, bevor Sie diese Adressen verwenden.
Integrationen müssen mehr als nur speichern ORCID Aufzeichnungen. Ihr System muss in der Lage sein:
- Akzeptieren und speichern ORCID IDs: Ihr System muss das wissen iD dauert ebenfalls 3 Jahre. Das erste Jahr ist das sog. ORCID Datensatz zur Anzeige der iD und korrekt zu aktualisieren. Speichern Sie es zusammen mit den Informationen des Forschers, die in der Token-Austauschantwort zurückgegeben werden. Wir empfehlen, die vollständige https-URI zu speichern: https://orcid.org/0000-0001-5727-2427.
- Akzeptieren und speichern Sie persistent Zugriffstoken und dem Token aktualisieren: Zugriffstoken können zum Lesen und Aktualisieren von Datensätzen sowie zum Anzeigen verwendet werden, dass die iD wurde authentifiziert. Zugriffstoken sind etwa 20 Jahre lang gültig oder bis der Benutzer sie widerruft. Wir empfehlen Ihnen außerdem, die Token-Bereich, Token-Ablauf und dem Token aktualisieren. Aktualisierungstoken können bei Bedarf verwendet werden, um neue Zugriffstoken mit demselben oder eingeschränktem Umfang zu erstellen. Speichern Sie die Daten des Zugriffstokens zusammen mit den Informationen des Forschers.
- Akzeptieren und speichern Codes eingeben : Jedes Element, das Sie hinzufügen, um ORCID Die Registrierung wird von der mit einem Put-Code zurückgegeben ORCID API. Speichern Sie diesen 6-stelligen Put-Code zusammen mit dem Artikel in Ihrem System. So können Sie erkennen, welcher Artikel gelesen, aktualisiert oder gelöscht werden muss.
- Geben Sie Fehlermeldungen und einen Support-Kontakt an, wenn eine Interaktion nicht wie erwartet verläuft.
Sie müssen das ausfüllen Formular zur Registrierung einer Kundenanwendung. Nachfolgend finden Sie einen kurzen Überblick über die angeforderten Felder:
Name der Organisation: Ihre ORCID Name der Mitgliedsorganisation
Primäre Kontakt-E-Mail-Adresse für Anmeldeinformationen: Wir verwenden diese E-Mail-Adresse, um Ihnen die Anmeldeinformationen in einer verschlüsselten E-Mail zu senden und Sie zu kontaktieren, wenn bei Ihrer Integration Fragen oder Fehler auftreten.
Sekundäre E-Mail für Passwort: Eine E-Mail-Adresse, an die wir Ihr verschlüsseltes E-Mail-Passwort senden können.
Name Ihres Auftraggebers: Das wird dein ORCID Name der Mitgliedsorganisation. Wenn Sie mehr als eine Integration haben, hängen wir die Anwendung an den Namen an.
URL der Homepage Ihrer Anwendung: Wird als Link in der Liste der vertrauenswürdigen Organisationen innerhalb der Benutzer angezeigt ORCID Seite „Vertrauenswürdige Parteien“. Dies sollte ein Link zurück zu Ihrer Organisation oder zur Hauptseite Ihrer Bewerbung sein.
Kurze Beschreibung Ihrer Client-Anwendung: Dieser Text wird Ihren Integrationsbenutzern auf dem Autorisierungsbildschirm mit dem Fragezeichensymbol angezeigt. Eine kurze Beschreibung Ihrer Integration ist erforderlich
URIs umleiten: Sobald der Benutzer Ihre Anwendung autorisiert hat, werden sie an einen von Ihnen angegebenen URI zurückgegeben. Sie müssen diese URIs im Voraus bereitstellen, da sonst bei Ihren Integrationsbenutzern ein Fehler auftritt.
- Es werden nur HTTPS-URIs akzeptiert.
- Registrierte Domänen müssen exakt mit den verwendeten Domänen (einschließlich Subdomänen) übereinstimmen.
- Registrieren Sie nach Möglichkeit alle Weiterleitungs-URIs vollständig.
- Mehr als 5 Weiterleitungs-URIs erforderlich? Bitte geben Sie dies in den Anmerkungen an ORCID Mitarbeiter.
Hinweise für ORCID Personal: Verwenden Sie dieses Feld zum Zulassen ORCID Mitarbeiter weitere Informationen zu Ihrem Anliegen oder Ihrer Integration
Es gibt eine Reihe von Anforderungen, die wir von allen Mitgliederintegrationen erwarten. Der ORCID Das Team stellt im Rahmen des Integrationsüberprüfungsprozesses sicher, dass diese Anforderungen erfüllt wurden.
- Verwenden Sie die OAuth zu authentifizieren ORCID iDs (Erlauben Sie Benutzern nicht, nach IDs zu suchen oder etwas einzugeben ORCID IDs.)
- Präsentieren Sie den OAuth-Autorisierungsbildschirm gemäß unserem Richtlinien
- Fügen Sie ein ORCID gebrandeter Button oder Link auf Ihrer Website, um die Authentifizierung der iD einzuleiten.
- Verwenden Sie HTTPS für die Umleitungs-URIs Ihrer Website und darüber hinaus ORCID API-Aufrufe
- Akzeptieren und speichern Sie alle im Token-Austausch zurückgegebenen Daten zusammen mit den Benutzerdaten in Ihrem System
- Verwenden Sie geeignete Zielfernrohre und dem Anforderungsmethoden (z. B. POST-Aufrufe zum Hinzufügen neuer Informationen und PUT-Aufrufe zum Aktualisieren vorhandener Informationen)
- Zeigen Sie die authentifizierten Dokumente öffentlich an ORCID IDs. IDs sollten gemäß unserer angezeigt werden Marke und iD Anzeigerichtlinien.
- Unterlassen Sie Fordern Sie Benutzer auf, ihre Sichtbarkeitseinstellungen für Elemente auf ihrem zu ändern ORCID Datensatz, um Ihre Integration zu verwenden.
Wir empfehlen Entwicklern, die öffentliche API im zu testen Sandbox-Testserver bevor Sie die Produktionsversion verwenden. Nachfolgend finden Sie die Schritte zur Registrierung für öffentliche API-Anmeldeinformationen sowohl in der Sandbox- als auch in der Produktionsumgebung.
- Melden Sie sich in Ihrem ORCID Aufzeichnung:
Produktionsserver: https://orcid.org/signin
Sandbox-Testserver: https://sandbox.orcid.org/signin - Klicken Sie oben rechts auf Ihren Namen
- Klicken Sie Entwicklertools aus der Menüoption
Hinweis: Um auf die Entwicklertools zugreifen zu können, müssen Sie Ihre E-Mail-Adresse bestätigen. Wenn Sie Ihre E-Mail-Adresse noch nicht bestätigt haben, werden Sie dazu aufgefordert, bevor Sie sich für öffentliche API-Anmeldeinformationen registrieren können - Lesen Sie die 'ORCID Nutzungsbedingungen für öffentliche Kunden
- Klicken Sie auf „Registrieren für“. ORCID „Öffentliche API-Anmeldeinformationen“-Schaltfläche.
Ausfüllen des Formulars mit den Bewerbungsdetails
- Sobald Sie sich für Ihre öffentlichen API-Anmeldeinformationen registriert haben, werden Sie zurück zu den Entwicklertools weitergeleitet (https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools).
- Sie müssen das Formular mit den Bewerbungsdetails ausfüllen, um eine neue Bewerbung zu registrieren.
- Name: Der Name Ihrer Anwendung. Dies wird den Benutzern angezeigt, wenn sie Ihrer Anwendung die Erlaubnis erteilen, ihre zu erhalten ORCID iD, und es wird in ihrem angezeigt Liste vertrauenswürdiger Organisationen. Wir empfehlen, den Namen Ihrer Organisation oder Ihres Dienstes zu verwenden (z. B. den Namen einer Zeitschrift).
- Anwendungs-URL: Die Website, die der Benutzer besuchen kann, um mehr über Ihre Anwendung zu erfahren. Dies wird auch in ihrem angezeigt Liste vertrauenswürdiger Organisationen.
- Anwendungsbeschreibung: Informationen über die Anwendung, die Sie entwickeln, und wie Sie die des Benutzers verwenden werden ORCID Ausweis. Dies wird den Benutzern auf dem OAuth-Bildschirm angezeigt.
Hinzufügen Umleitungs-URIs
Sobald der Benutzer Ihre Anwendung autorisiert hat, werden sie an einen von Ihnen angegebenen URI zurückgegeben. Sie müssen diese URIs im Voraus bereitstellen, da sonst bei Ihren Integrationsbenutzern ein Fehler auftritt.
- Geben Sie Ihren Weiterleitungs-URI in das dafür vorgesehene Feld ein
- Wenn Sie mehr als einen Umleitungs-URI eingeben müssen, klicken Sie auf „Weiteren Umleitungs-URI hinzufügen“.
Bitte beachte:
- Nur HTTPS-URIs werden in die Produktion übernommen
- Domains registriert MUST macht exakt mit den verwendeten Domains, inklusive Subdomains, übereinstimmen
- Registrieren Sie nach Möglichkeit alle Weiterleitungs-URIs vollständig. Dies ist die sicherste Option und wird von uns empfohlen. Weitere Informationen zu Weiterleitungs-URIs finden Sie in unserem FAQ zur Umleitungs-URI
Speichern Ihrer Bewerbung
Sobald Sie das Bewerbungsformular ausgefüllt und Ihre Weiterleitungs-URIs hinzugefügt haben, können Sie Ihre Bewerbung speichern.
- Klicken Sie auf „Meine Anwendung speichern und meine Client-ID und mein Geheimnis generieren“.
Sie werden zurück zur Entwicklertools-Seite weitergeleitet, die nun Ihre Anmeldeinformationen für den öffentlichen API-Client enthält
Aktualisieren Ihrer Anmeldeinformationen
Eine Änderung Ihrer Bewerbungsinformationen ist sehr einfach.
- Bearbeiten Sie die relevanten Informationen und klicken Sie dann auf „Antrag speichern“.
Nutzen Sie Ihre Anmeldedaten
Da Sie nun über Ihre Anmeldeinformationen verfügen, ist es an der Zeit, mit der Nutzung zu beginnen ORCID Öffentliche API!
Bitte beachten Sie, dass wir Ihre Zugangsdaten an die Mitglieder-API übertragen können, wenn Sie Mitglied werden ORCID Mitglied in der Zukunft.
Anfrage der Mitgliedsorganisationen ORCID Mitglieds-API-Anmeldeinformationen auf dem Produktionsserver (Liveserver), indem Sie Folgendes ausfüllen Antragsformular für den Production Member API-Client. Vor der Ausgabe der API-Anmeldeinformationen für Produktionsmitglieder muss die ORCID Das Engagement-Team/der Konsortialleiter wird eine Demo Ihrer Integration im ORCID Sandbox. Dies gibt uns die Möglichkeit, die großartigen Integrationen zu sehen, die Sie erstellt haben, und Workflow-Verbesserungen anzubieten. Außerdem können wir prüfen, ob alle Integrationen unseren Best Practices und Mindestanforderungen für den Start entsprechen.
Um eine Demo Ihres Systems bereitzustellen, müssen Sie eine funktionierende Integration mit dem einrichten ORCID Sandbox, die die ORCID Das Team kann eine Vorschau anzeigen. Es gibt mehrere Möglichkeiten, Ihre funktionierende Sandbox-Integration zu teilen:
- Empfohlen: Live-Demo: Kontaktieren Sie uns, um eine Live-Demonstration zu vereinbaren. Wir stellen Ihnen eine Meeting-Software zur Verfügung, mit der Sie Ihren Bildschirm freigeben können, um Ihre Integration vorzuführen.
- Testseite: Wenn Ihre Entwicklungsseite öffentlich ist, Schicken Sie uns die URL zusammen mit Testanmeldeinformationen (falls erforderlich) für den Zugriff auf Ihr System und Anweisungen zur Verwendung Ihres Systems ORCID Merkmale. Stellen Sie zusätzliche Dokumentation bereit, um zu überprüfen, was wir vom Benutzer aus nicht sehen können, z. B. die verwendete API-Version, welche Daten von Ihrem System gespeichert werden usw.
- Screencast oder Screenshots:Senden Sie eine Aufnahme oder eine Reihe von Screenshots mit Beschreibungen, die klar erklären und demonstrieren, wie Ihre Integration in jedem Schritt funktioniert, einschließlich dessen, was passiert, wenn ein Benutzer den Zugriff verweigert oder seine iD trennt. Stellen Sie sicher, dass Sie zusätzliche Unterlagen bereitstellen, um alles zu verifizieren, was wir vom Benutzer aus nicht sehen können, z. B. die verwendete API-Version und wie Daten gespeichert werden
Such- und Link-Assistenten sind Integrationen, mit denen Artikel (hauptsächlich Werke) in die importiert werden können ORCID Registrierung. Sie müssen zwischen dem Integrator und getestet werden ORCID bevor sie in der Produktionsregistrierungsumgebung freigegeben werden können.
Abhängig von Ihren Antworten auf die folgenden Fragen ist Ihre Integration möglicherweise ein geeigneter Kandidat für die Suche und Verknüpfung. Bitte kontaktieren Sie uns, um dies weiter zu besprechen, bevor Sie mit der Entwicklung eines Such- und Verknüpfungsassistenten beginnen:
- Was ist die Zielgruppe des Zauberers? Zum Beispiel Autoren, Gutachter oder Fördermittelantragsteller auf nationaler, disziplinärer oder globaler Ebene
- Wie groß ist ungefähr das erwartete Publikum?
- Wird es einer Bevölkerung dienen, die derzeit von bestehenden Zauberern unterversorgt ist? Zum Beispiel Forschungsbeiträge in einer bestimmten Sprache oder Disziplin oder neuartiger Art
- Wie stellen Sie sicher, dass der Assistent eine gute Benutzererfahrung bietet?
- Welchen Benutzersupport bieten Sie an?
- Gibt es – oder wird es eine geben? ORCID Welche Ansprechpartner in Ihrer Organisation, beispielsweise ein Produktmanager, für den Assistenten?
- Wie stellen Sie das sicher? ORCID IDs werden authentifiziert?
- Nehmen Sie – oder werden Sie – etwas auf und zeigen Sie es an? ORCID iDs auf Ihrer Plattform?
- Ist Ihre Plattformsuche durch iDs aktiviert?
Bitte beachten Sie unsere Such- und Link-Workflow für weitere Informationen an.
Webhooks ermöglichen Premium-Mitgliedern das „Zuschauen“ ORCID Aufzeichnungen und werden über alle Änderungen benachrichtigt.
Mithilfe der API und der Anmeldeinformationen des Premium-Mitglieds können Premium-Mitglieder für jede authentifizierte Person eine Rückruf-URL registrieren ORCID iD die sie verfolgen möchten. Der ORCID Der Datensatzinhaber muss der Organisation keine spezielle Erlaubnis zur Registrierung der URL erteilen, der tatsächliche Datenaustausch basiert jedoch auf den von der Organisation festgelegten Datenschutzniveaus ORCID iD Halter.
Damit ist alles vorhanden ORCID benachrichtigt die angegebene URL durch Senden einer Anfrage, wenn Änderungen an der vorgenommen werden ORCID Rekord.
Um einen /lesebeschränkten Zugriff zu erhalten, müssen Sie den Forscher um Erlaubnis bitten. Sie tun dies mit OAuth. Konkret: „3-beiniges OAuth".
Weitere Informationen finden Sie in unserem API-Tutorial: Lesen Sie Daten auf einem ORCID Rekord
Jeder mit öffentlichen oder Mitglieds-API-Anmeldeinformationen kann eine erhalten /read-public Zugangstoken. Um einen Token zu erhalten, rufen Sie an ORCID API-Token-Endpunkt.
Dieser Prozess wird oft als OAuth-Ablauf für Client-Anmeldeinformationen oder 2-stufiges OAuth bezeichnet.
Ein Beispielaufruf zum Erhalten eines Zugriffstokens zum Lesen öffentlicher Daten in der Sandbox – ersetzen Sie die Platzhalter durch Ihre Anmeldeinformationen (entfernen Sie unbedingt die Klammern).
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public API client ID]
client_secret=[Your public API secret]
grant_type=client_credentials
scope=/read-public
Sie erhalten dann ein Zugriffstoken ähnlich dem folgenden zurück. Der zurückgegebene Token ist langlebig (er läuft etwa 20 Jahre lang nicht ab) und kann mehrfach zum Abrufen öffentlicher Daten verwendet werden ORCID Records.
{"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer",
"refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518,
"scope":"/read-public","orcid":null}
Hinweis: Alle Token mit dem Geltungsbereich /authenticate enthalten jetzt auch den Geltungsbereich /read-public. Wenn Sie nur den Bereich /authenticate verwenden, können Sie die gespeicherten Zugriffstoken zum Lesen öffentlicher Daten verwenden, ohne erneut ein Zugriffstoken anfordern zu müssen.
Integratoren, die die Mitglieds-API verwenden, können die verwenden /read-public Spielraum zum Lesen ORCID Zusammenfassungen aufzeichnen.
Wenn Sie um Erlaubnis zur Interaktion mit einem bitten ORCID Im Datensatz des Benutzers geben Sie einen oder mehrere „Bereiche“ an. In jedem Bereich können Sie bestimmte Dinge tun, z. B. den Datensatz lesen oder einen bestimmten Abschnitt aktualisieren.
Dreibeinig bezieht sich auf die drei Akteure, die an der Einholung der Erlaubnis eines Benutzers beteiligt sind; ORCID, Ihr System und der Benutzer selbst.
/authentifizieren
Dieser Bereich wird zum Sammeln der verwendet ORCID iD und lesen Sie öffentliche Informationen nur in der Akte. Alle anderen dreibeinigen Bereiche umfassen die Authentifizierungsberechtigung, sodass dieser Bereich weggelassen werden kann, wenn Sie einen anderen Zugriff anfordern. Dieser Bereich ist in der Member- oder Public-API verfügbar.
/read-limited (nur Mitglieder-API)
Dieser Bereich wird verwendet, um Zugriff zum Lesen öffentlicher und eingeschränkt sichtbarer Elemente auf einem zu erhalten ORCID aufzeichnen. Dieser Bereich ist nur auf der Member-API verfügbar.
/activities/update (nur Mitglieder-API)
Dieser Bereich wird zum Schreiben, Aktualisieren und Löschen von Einträgen in den Abschnitten Zugehörigkeit, Finanzierung, Werke, berufliche Aktivitäten, Forschungsressourcen und Peer-Review eines ORCID aufzeichnen. Dieser Bereich ist nur auf der Member-API verfügbar.
/person/update (nur Mitglieder-API)
Dieser Bereich wird zum Schreiben, Aktualisieren und Löschen von Elementen in den Abschnitten „Andere Namen“, „Schlüsselwörter“, „Länder“, „Forscher-URLs“, „Websites“ und „Persönliche externe Identifikatoren“ des Datensatzes verwendet. Dieser Bereich ist nur auf der Member-API verfügbar.
openid
Dieser Bereich wird von OpenID-Integratoren verwendet, wenn ein id_token erforderlich ist. Wenn der openid-Bereich enthalten ist, gibt die Registry ein id_token in der Token-Antwort zurück und erteilt dem Client die Berechtigung, auf den Benutzerinformationsendpunkt für diesen Benutzer zuzugreifen. Dieser Bereich ist in der öffentlichen und Mitglieder-API verfügbar.
Bitte beachten Sie, dass der Bereich „openid“ nicht wie der andere mit einem „/“ beginnt ORCID API-Bereiche. Dies liegt daran, dass der Bereich „openid“ nicht durch definiert ist ORCID, sondern durch die OpenID Connect-Spezifikation definiert. Bitte sehen Sie sich unsere an OpenID-Dokumentation um mehr zu erfahren.
Mehrere Bereiche
In einer einzigen Interaktion können mehrere Bereiche angefordert werden, indem die Bereiche in der Authentifizierungs-URL mit einem codierten Leerzeichen dazwischen aufgelistet werden, z. B. „scope=/read-limited%20/activities/update%20/person/update“.
Vollständiger Zugriff
Wenn Sie vollen Zugriff zum Lesen und Bearbeiten eines Datensatzes wünschen, schließen Sie drei Bereiche in Ihre Authentifizierungs-URL ein: /read-limited, /activities/update und /person/update. In der URL würden sie als „scope=/read-limited%20/activities/update%20/person/update“ erscheinen
Zweibeinige Bereiche (Client-Anmeldeinformationen).
Für einige Aktivitäten müssen Sie den Benutzer nicht um Erlaubnis bitten. Zweibeinige OAuth-Bereiche werden direkt vom angefordert ORCID API und erfordern keine Erlaubnis des Forschers. Token mit diesen Gültigkeitsbereichen sind 20 Jahre lang gültig und können wiederverwendet werden
/read-public
Dieser Bereich wird verwendet, um öffentliche Informationen zu einem einzelnen zu lesen ORCID iD,Suche nach ORCID Datensätze oder zum Lesen von Übersichtsinformationen (nur Mitglieds-API). Dieser Bereich ist für die Mitglieds- oder öffentliche API verfügbar.
/ Webhook
Dieser Bereich ermöglicht es einer Clientanwendung, einen Webhook auf einem zu registrieren ORCID Datensatz, um Benachrichtigungen zu erhalten, wenn ein Datensatz aktualisiert wird. Dieser Umfang steht Premium zur Verfügung ORCID nur für Mitglieder.
ORCID Integrationen verwenden „3-beiniges OAuth“, um Benutzer zu authentifizieren und die Erlaubnis zur Interaktion mit ihren Datensätzen anzufordern. Jede Integration kann mithilfe der öffentlichen API Leseberechtigungen anfordern. ORCID Mitglieder können die Mitglieder-API verwenden, um Aktualisierungsberechtigungen anzufordern. Es funktioniert so:
- Sie erstellen einen speziellen Link
- Beim Anklicken wird der Benutzer weitergeleitet ORCID
- ORCID fordert den Benutzer auf, sich anzumelden
- ORCID fordert den Benutzer auf, Ihrer Anwendung die Erlaubnis zu erteilen
- ORCID sendet den Benutzer mit einem Autorisierungscode an Ihr System zurück
- Ihr System tauscht diesen Code gegen ein Zugriffstoken aus
Die benutzerdefinierte Autorisierungs-URL enthält Ihre Kundeninformationen sowie die „Bereiche“, die die spezifischen Bereiche ihres Datensatzes angeben, auf die Sie zugreifen möchten. Nach der Anmeldung autorisiert der Benutzer die Verbindung mit Ihrem System und wird zusammen mit einem Autorisierungscode zu Ihrer Zielseite zurückgeleitet. Dieser Code wird dann verwendet, um ihre zu erhalten ORCID iD zusammen mit einem Zugriffstoken, das für die angeforderten Bereiche gültig ist.
Sie erstellen Ihren Autorisierungslink, indem Sie die Client-ID Ihrer API-Anmeldeinformationen und die zugehörige Zielseite (Umleitungs-URI) angeben. Sie wählen aus, welche Berechtigungen angefordert werden sollen, indem Sie der Scope-Parameter.
Im folgenden Beispiel wird die Erlaubnis zum Lesen von Daten mit eingeschränktem Zugriff angefordert ORCID Sandbox-Testserver. In der realen Welt zeigen Sie diesen Link auf Ihrer Website an oder fügen ihn in eine E-Mail ein, wenn Sie den Benutzer zur Authentifizierung und Autorisierung auffordern. Zu Testzwecken können Sie es jedoch einfach in Ihren Webbrowser einfügen. Ersetzen Sie die Daten in Klammern durch Ihre Kundeninformationen und entfernen Sie unbedingt die eckigen Klammern!
https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]
Sobald der Benutzer auf den Link geklickt hat, hat er sich angemeldet ORCID und erteilten Berechtigungen werden sie auf Ihre Website zurückgeleitet, wie folgt:
https://[Your landing page]?code=Q70Y3A
Sie sollten den Autorisierungscode umgehend gegen den austauschen ORCID iD und Zugriffstoken. Der Autorisierungscode verfällt bei Verwendung. Die Anfrage sieht so aus und kann nicht in einem Webbrowser erstellt werden, es muss von Ihrem Server erstellt werden.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
HEADER: Content-Type: application/x-www-form-urlencoded
METHOD: POST
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
grant_type=authorization_code
code=Six-digit code
redirect_uri=[Your landing page]
ORCID wird dann die Authentifizierung des Forschers zurücksenden ORCID iD und ein Zugriffstoken im JSON-Format:
{"access_token":"f5af9f51-07e6-4332-8f1a-c0c11c1e3728","token_type":"bearer",
"refresh_token":"f725f747-3a65-49f6-a231-3e8944ce464d","expires_in":631138518,
"scope":"/read-limited","name":"Sofia Garcia","orcid":"0000-0001-2345-6789"}
Zugriffstoken haben standardmäßig eine lange Lebensdauer und verfallen 20 Jahre nach der Ausstellung. Der Token kann mehrfach verwendet werden, bevor er abläuft.
Verwenden Sie das Zugriffstoken
Dreibeinige Zugriffstoken sind mit bestimmten verknüpft ORCID aufzeichnen. Um sie zu verwenden, fügen Sie sie in API-Anfragen ein, die Sie zum Lesen oder Aktualisieren dieses Datensatzes stellen.
Nutzer können ihre Anzeigesprache jederzeit selbständig ändern. Folgende Spracheinstellungen stehen zur Verfügung:
Sprache | Code |
عربى (Arabisch) | ar |
čeština (tschechisch) | cs |
Englisch | en |
Español (Spanisch) | es |
Français (Französisch) | fr |
Deutsch (German) | de |
Italiano (Italienisch) | it |
日本語 (Japanisch) | ja |
한국어 (Koreanisch) | ko |
Polski (Polnisch) | pl |
Português (Portugiesisch) | pt |
Русский (russisch) | ru |
Türkçe (Türkisch) | tr |
简体中文 (vereinfachtes Chinesisch) | zh_CN |
繁體中文 (traditionelles Chinesisch) | zh_TW |
Wenn Sie befürchten, dass sich mehrere Benutzer auf demselben Computer befinden und sich zwischen den Sitzungen nicht abmelden, können Sie sie während des OAuth-Vorgangs zu einer erneuten Authentifizierung zwingen. Einfach einbinden prompt=login
in der OAuth-Anfrage. Sie können auch ein max_age in Sekunden festlegen, um Benutzer zu einer erneuten Authentifizierung zu zwingen, wenn ihre Sitzung eine bestimmte Länge überschreitet. Sehen Sie sich unsere an OpenID Connect-Dokumentation für weitere Informationen an.
Implizites OAuth ist eine leichtere Version von OAuth, die für die Verwendung durch Systeme entwickelt wurde, die keine serverseitigen Komponenten haben oder nicht verwenden möchten. Implizites OAuth kann allein mit Javascript vollständig im Browser implementiert werden. Es steht Mitgliedern und Nichtmitgliedern zur Verfügung und funktioniert wie folgt:
- Sie erstellen einen speziellen Link
- Beim Anklicken wird der Benutzer weitergeleitet ORCID
- ORCID fordert den Benutzer auf, i zu unterschreiben
- ORCID fordert den Benutzer auf, Ihrer Anwendung die Erlaubnis zu erteilen
- ORCID schickt den Benutzer mit seinem zurück zu Ihrem System ORCID iD, ein Zugriffstoken und ein ID-Token.
- Ihr System extrahiert und speichert die authentifizierten Daten ORCID iD aus der Antwort.
Aus Sicherheitsgründen gilt bei der Verwendung von implizitem OAuth: ORCID gibt keine Zugriffstoken mit Aktualisierungsberechtigungen zurück.
Impliziter Fluss
Der implizite Fluss ist so konzipiert, dass Clients zum Initiieren nicht ihren geheimen Schlüssel verwenden müssen ORCID Anmelden. Die Sicherheit wird durch die Beschränkung der Clients auf ihre registrierten Redirect_URLs gewährleistet. Dieses niedrigere Sicherheitsniveau bedeutet dies ORCID Unterstützt nur die Bereiche /authenticate und openid, wenn der implizite Fluss verwendet wird. Token sind mit einer Lebensdauer von 10 Minuten ebenfalls kurzlebig. Dieser Ablauf wird für clientseitige Anwendungen empfohlen, die keinen Zugriff auf einen Back-End-Server haben, beispielsweise Telefonanwendungen oder einseitige Javascript-Webanwendungen.
https://localhost/#access_token=24c11342-f5da-4cf9-94a4-f8a72a30da00&token_type=bearer&expires_in=599&tokenVersion=1&persistent=false&id_token=eyJraWQiOiJxYS1vcmNpZC1vcmctcjlhZmw3cWY2aG2c5bmdzenU1bnQ3Z3pmMGVhNmkiLCJhbGciOiJSUzI1NiJ9.eyJhdF9oYXNoIjoiMW52bXZBbVdwaVd0Z3ZKZW1DQmVYUSIsImF1ZCI6IkFQUC02TEtJSjNJNUIxQzRZSVFQIiwic3ViIjoiMDAwMC0wMDAyLTUwNjItMjIwOSIsImF1dGhfdGltZSI6MTUwNTk4Nzg2MiwiaXNzIjoiaHR0cHM6XC9cL29yY2lkLm9yZyIsIm5hbWUiOiJNciBDcmVkaXQgTmFtZSIsImV4cCI6MTUwNTk4ODQ2MywiZ2l2ZW5fbmFtZSI6IlRvbSIsImlhdCI6MTUwNTk4Nzg2Mywibm9uY2UiOiJ3aGF0ZXZlciIsImZhbWlseV9uYW1lIjoiRGVtIiwianRpIjoiY2U0YzlmNWUtNTBkNC00ZjhiLTliYzItMmViMTI0ZDVkNmNhIn0.hhhts2-4-ibjXPW6wEsFRaNqV_A-vTz2JFloYn7mS1jzQt3xuHiSaSIiXg3rpnt1RojF_yhcvE9Xe4SOtYimxxVycpjcm8yT_-7lUSrc46UCt9qW6gV7L7KQyKDjNl23wVwIifpRD2JSnx6WbuC0GhAxB5-2ynj6EbeEEcYjAy2tNwG-wcVlnfJLyddYDe8AI_RFhq7HrY4OByA91hiYvHzZ8VzoRW1s4CTCFurA7DoyQfCbeSxdfBuDQbjAzXuZB5-jD1k3WnjqVHrof1LHEPTFV4GQV-pDRmkUwspsPYxsJyKpKWSG_ONk57E_Ba--RqEcE1ZNNDUYHXAtiRnM3w
Sie finden weitere Information unter den jeweiligen Technische Dokumentation um mehr zu erfahren.
Wenn bereits ein aktives Zugriffstoken mit denselben Bereichen vorhanden ist, die Ihre OAuth-Autorisierungs-URL anfordert, und der Benutzer dort angemeldet ist ORCID werden sie nicht erneut aufgefordert, die Autorisierung zu erteilen. Stattdessen werden sie direkt zum Umleitungs-URI weitergeleitet. Wenn Sie möchten, dass ein Benutzer bei jeder Verbindung eine Autorisierung erteilt, verwenden Sie die Abmeldemethode erzwingen
Es können einzelne oder alle Parameter verwendet werden:
Parameter | Feld | Notizen |
Vornamen | Vorname | Der Vorname Das Feld wird auf dem ausgefüllt Anmeldeformular wenn eine angegebene E-Mail-Adresse bzw ORCID iD entspricht nicht dem eines aktiven ORCID Rekord. |
Familiennamen | Familienname | Der Nachname Das Feld wird auf dem ausgefüllt Anmeldeformular wenn die angegebene E-Mail-Adresse bzw ORCID iD entspricht nicht dem eines aktiven ORCID Rekord. |
Der Email/ORCID iD Das Feld wird auf dem ausgefüllt Anmeldeformular wenn die angegebene E-Mail-Adresse in unserem System gefunden und nicht gültig ist ORCID iD angegeben ist.Die E-Mail Das Feld wird auf dem ausgefüllt Anmeldeformular wenn die angegebene E-Mail-Adresse in unserem System gefunden und nicht gültig ist ORCID iD angegeben ist. Die E-Mail-Adresse sollte sein URL-codiert, einschließlich der Änderung von „@“ in „%40“. Wenn Sie den Benutzer kennen ORCID iD und E-Mail-Adresse empfehlen wir einzige Bereitstellung der ORCID iD im orcid-Parameter. | ||
orcid | ORCID iD | Der Email/ORCID iD Das Feld wird auf dem ausgefüllt Anmeldeformular wenn das angegebene ORCID iD ist in unserem System zu finden.Die Anmeldeformular wird andernfalls angezeigt, wenn der angegebene Wert vorliegt ORCID iD wird in unserem System nicht gefunden ORCID iD muss in der sein 16-stelliges Format des iD URI. |
Eine Beispiel-URL mit diesen Parametern ist
https://sandbox.orcid.org/oauth/authorize?client_id=APP-NPXKK6HFN6TJ4YYIn&response_type=coden&scope=/authenticaten&redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplaygroundn&family_names=Finn&given_names=Huckleberry&email=huckle%40mailinator.com
OpenID Connect 1.0 ist eine einfache Identitätsschicht auf dem OAuth 2.0-Protokoll. Es ergänzt bestehende OAuth-Authentifizierungsabläufe und stellt Clients auf gut beschriebene Weise Informationen über Benutzer bereit.
OpenID Connect ist eine standardisierte Methode zur Implementierung von OAuth und zum Austausch von Informationen über authentifizierte Benutzer. Es ist nun möglich, die zu verwendenden Dienste zu konfigurieren ORCID „out of the box“ neben anderen standardkonformen OpenID Connect-Anbietern. OpenID Connect bietet auch gemeinsam nutzbare ID-Token, signierte Objekte, die einen Benutzer authentifizieren können, indem ORCID zu einem bestimmten Zeitpunkt. Diese Token können von Elementen der Benutzeroberfläche verwendet werden, um Benutzersitzungen aufrechtzuerhalten.
ORCID unterstützt das Basic OpenID Provider-Konformitätsprofil, das eine Erweiterung des OAuth-Autorisierungscodeflusses ist. ORCID Unterstützt auch den impliziten Tokenfluss für die Bereiche „/authenticate“ und „openid“.
Dies bedeutet, dass ORCID:
- Bettet signierte ID-Token in Token-Antworten für Autorisierungscodes ein, die mit dem Bereich „OpenID“ generiert wurden.
- Unterstützt den impliziten Fluss bei Verwendung der Antworttypen „token“ oder „token id_token“ und des Bereichs „openid“.
- Unterstützt die Parameter „prompt“, „nonce“ und „max_age“ für Autorisierungsanfragen, die den Bereich „openid“ umfassen.
- Unterstützt Openid Connect-Erkennungs- und Benutzerinfo-Endpunkte
- Unterstützt das Feld „amr“ für Integratoren, die die Mitglieds-API für Autorisierungsanfragen verwenden, die den Bereich „openid“ umfassen. Dies kann verwendet werden, um herauszufinden, ob sich ein Benutzer mithilfe der Zwei-Faktor-Authentifizierung authentifiziert hat.
Das Initiieren einer OpenID Connect-Authentifizierung funktioniert auf die gleiche Weise wie eine reguläre OAuth-Authentifizierung. Alles, was erforderlich ist, ist, dass der Client den Bereich „openid“ anfordert. Wenn Sie den Bereich „/authenticate“ verwenden, ersetzen Sie ihn durch „openid“, da „authenticate“ und „openid“ dieselbe Berechtigung haben, sollte nur das eine oder das andere verwendet werden. Wenn Sie andere Bereiche verwenden, fügen Sie openid zur Liste der angeforderten Bereiche hinzu. Wenn der openid-Bereich enthalten ist, gibt die Registry ein id_token in der Token-Antwort zurück und erteilt dem Client die Berechtigung, auf den Benutzerinformationsendpunkt für diesen Benutzer zuzugreifen.
Beachten Sie, dass der Bereich „openid“ nicht wie der andere mit einem „/“ beginnt ORCID API-Bereiche. Dies liegt daran, dass der Bereich „openid“ nicht durch definiert ist ORCID, sondern durch die OpenID Connect-Spezifikation definiert.
Sie finden weitere Information unter den jeweiligen Technische Dokumentation um mehr zu erfahren.
Was sind Weiterleitungs-URIs und wie werden sie verwendet?
Umleitungs-URIs werden von unserem OAuth-Authentifizierungsdienst als Sicherheitsmaßnahme verwendet. ORCID sendet authentifizierende Benutzer nur an URIs, die vom Client registriert wurden, der die Authentifizierung anfordert. Dadurch wird verhindert, dass Dienste sich gegenseitig verkörpern.
Bitte beachten Sie, dass nur HTTPS-URIs werden in die Produktion übernommen. Sie können die Verwendung von HTTP-URIs testen, müssen sich jedoch registrieren HTTPS-URIs wenn Sie API-Anmeldeinformationen für Produktionsmitglieder beantragen.
Wie gleichen wir Weiterleitungs-URIs ab?
- Sie MÜSSEN Subdomains als separate URIs registrieren. https://anythingelse.thirdparty.com wird nicht funktionieren.
- Es wird empfohlen, alle Umleitungs-URIs vollständig zu registrieren, einschließlich des Pfads, ist das, was die meisten Drittanbieter tun und die sicherste Option ist.
- Wenn die Client-App mit einem Umleitungs-URI registriert ist, der nur der Hostname ist, kann jeder Umleitungs-URI auf diesem Host verwendet werden. Wenn also beispielsweise die folgende Weiterleitungs-URI registriert ist: https://thirdparty.com dann funktionieren alle folgenden „redirect_uris“:
- https://thirdparty.com/oauth/callback1
- https://thirdparty.com/callback2
- https://thirdparty.com/anything-else-as-long-as-the-host-is-the-same
Allerdings https://anythingelse.thirdparty.com wird nicht funktionieren. Du MUST macht Registrieren Sie Subdomains als separate URIs.
Was passiert, wenn mein Weiterleitungs-URI falsch ist?
Benutzer, die zur Authentifizierung an gesendet wurden ORCID Bei falschen Umleitungs-URIs wird eine Fehlermeldung ähnlich dieser angezeigt:
Verwalten von Umleitungs-URIs für Mitglieder
Wenn Sie die Mitglieder-API verwenden und Änderungen an Ihren Weiterleitungs-URIs benötigen, wenden Sie sich bitte an unser Engagement-Team
Verwalten von Umleitungs-URIs für öffentliche Clients
Wenn Sie die öffentliche API verwenden, müssen Sie die folgenden Schritte ausführen, um Ihre Liste der Umleitungs-URIs zu aktualisieren, die mit Ihrem verknüpft sind ORCID öffentliche API-Client-ID. Sie können dies tun, indem Sie die folgenden Schritte ausführen:
- Melde dich bei dir an ORCID Rekord
- Klicken Sie in der rechten Ecke auf Ihren Namen
- Wählen Sie Entwicklertools aus
- Klicken Sie auf den Bearbeitungsstift neben dem Kundennamen
- Bearbeiten Sie einen vorhandenen Umleitungs-URI oder klicken Sie auf „Weiteren Umleitungs-URI hinzufügen“ und bearbeiten Sie einen vorhandenen
- Sobald Sie Ihre Änderungen vorgenommen haben, müssen Sie auf das Speichern-Symbol klicken
Nur HTTPS-URIs werden in die Produktion übernommen. Sie können die Verwendung von HTTP-URIs testen, müssen jedoch HTTPS-URIs registrieren, wenn Sie API-Anmeldeinformationen für Produktionsmitglieder beantragen.
ORCID Ermöglicht Benutzern die Aktivierung Zwei-Faktor-Authentifizierung (2FA) auf ihrem ORCID Konto. 2FA ist eine sekundäre Sicherheitsprüfung, die während des Anmeldevorgangs durchgeführt wird. Es bietet eine zusätzliche Bestätigung, dass der Benutzer tatsächlich die Person ist, die sich bei einem anmeldet ORCID Konto. Weitere Informationen dazu, wie dies für Benutzer konfiguriert werden kann, finden Sie in unserer KB-Artikel.
OpenID Connect-Integratoren können mithilfe der Mitglieder-API überprüfen, ob sich der Benutzer bei ihnen angemeldet hat ORCID Konto mit aktivierter 2FA als Teil des OAuth-Prozesses. Dadurch können Mitgliedsintegratoren ihren Forschern Zugriff auf Systeme mit höherer Sicherheit gewähren.
Registrierte Organisations-IDs – In diesem Abschnitt werden die Organisations-IDs angezeigt, die zum Generieren der Daten im Bericht verwendet wurden. Dies sind die IDs, die wir für Sie registriert haben ORCID Mitgliedschaft.
Anzahl der verbundenen Datensätze - Die Gesamtzahl der ORCID Aufzeichnungen, die einen öffentlichen Bezug haben (Beschäftigung, Ausbildung, Qualifikationen, Mitgliedschaft, Dienstleistungen, eingeladene Positionen und Auszeichnungen) innerhalb des Registers für Ihre Organisation. Bitte beachten Sie, dass es im Register möglicherweise weitere gibt, die keine Organisations-ID haben oder deren Sichtbarkeitseinstellung nicht „Jeder“ ist.
Anzahl Datensätze mit aktueller Zugehörigkeit – Die Gesamtzahl der ORCID Datensätze, die eine aktuelle öffentliche Zugehörigkeit innerhalb des Registers für Ihre Organisation haben. Eine aktuelle Zugehörigkeit ist eine Zugehörigkeit, für die kein Enddatum eingetragen ist. Bitte beachten Sie, dass es im Register möglicherweise weitere gibt, denen keine Organisations-ID zugeordnet ist oder die nicht die Sichtbarkeitseinstellung „Jeder“ haben.
Anzahl Datensätze mit aktueller Beschäftigungszugehörigkeit – Die Gesamtzahl der ORCID Datensätze, die eine aktuelle öffentliche Beschäftigungszugehörigkeit im Register für Ihre Organisation haben. Eine aktuelle Zugehörigkeit ist eine Zugehörigkeit, für die kein Enddatum eingetragen ist. Bitte beachten Sie, dass es im Register möglicherweise weitere gibt, denen keine Organisations-ID zugeordnet ist oder die nicht die Sichtbarkeitseinstellung „Jeder“ haben.
Gesamtzugehörigkeiten – Die Gesamtzahl der öffentlichen Zugehörigkeiten innerhalb des Registers für Ihre Organisation. Dies umfasst aktuelle und vergangene Zugehörigkeiten. Bitte beachten Sie, dass es im Register möglicherweise weitere gibt, denen keine Organisations-ID zugeordnet ist oder die nicht die Sichtbarkeitseinstellung „Jeder“ haben.
Im Laufe der Zeit entstandene Zugehörigkeiten – Ein Diagramm, das die Anzahl der Zugehörigkeiten zeigt, die im Laufe der Zeit zur Registrierung hinzugefügt wurden. Das Diagramm ist nach Zugehörigkeiten unterteilt, die Ihre Organisation hinzugefügt hat, und nach Zugehörigkeiten, die von Ihren Forschern manuell hinzugefügt wurden
Im Laufe der Zeit erstellte Zugehörigkeiten nach Typ – Ein Diagramm, das die Arten von Zugehörigkeiten zeigt, die im Laufe der Zeit hinzugefügt wurden.
Im Laufe der Zeit von der ORG-ID erstellte Zugehörigkeiten – Ein Diagramm, das die Anzahl der im Laufe der Zeit nach ORG-ID hinzugefügten Zugehörigkeiten zeigt.
ORCID bietet eine einfache Java-Script-Widget mit dem man sich authentifizieren kann ORCID iDs mit OAuth mit OpenID Connect.
Bitte beachten Sie, dass das Widget implizites OAuth verwendet und daher keine Schreibberechtigungen sammelt. Dies bedeutet, dass es nicht für Mitgliederintegrationen geeignet ist, die Datensätze aktualisieren möchten. Bitte sehen Sie sich unser Tutorial an Hinzufügen und Aktualisieren von Daten zu ORCID Records.
In Übereinstimmung mit Unser Engagement für die Kontrolle der Forscher über ihre ORCID Rekord, kann der Datensatzinhaber jedes Zugriffstoken jederzeit widerrufen, indem er es aus den Berechtigungen in der löscht Vertrauenswürdige Organisationn-Liste auf der Seite „Vertrauenswürdige Parteien“.
Ab 2018 können Forscher nur noch langlebige Zugriffstoken mit einer Gültigkeitsdauer von 20 Jahren vergeben, es sei denn, der Benutzer widerruft die Erlaubnis.
Öffentlich angeschlossen ORCID Aufzeichnungen – Eine Liste der ORCID Datensätze, die eine öffentliche Zugehörigkeit zu Ihrer Organisation aufweisen. Öffentliche Zugehörigkeiten sind solche, deren Sichtbarkeit im Register auf „jeder“ eingestellt ist. Die Liste enthält die ORCID Personalausweis, Vorname, Nachname und Kreditname
Derzeit öffentlich angestellt ORCID Aufzeichnungen - Eine Liste von ORCID Aufzeichnungen, die eine öffentliche Beschäftigungszugehörigkeit zu Ihrer Organisation aufweisen. Öffentliche Zugehörigkeiten sind solche, deren Sichtbarkeit im Register auf „jeder“ eingestellt ist. Die Liste enthält die ORCID ID, Vorname, Nachname und Startdatum der Zugehörigkeit
Öffentliche Zugehörigkeiten mit Zugehörigkeitsdaten– Eine Liste der öffentlichen Zugehörigkeiten zu Ihrer Organisation. Die Liste enthält ORCID ID, Vorname, Nachname, Typ, Titel, Abteilung, Start- und Enddatum, Hinzufügungsdatum ORCID, Datum der letzten Änderung für die Zugehörigkeit, Quelle, Org-ID-Typ und Org-ID-Wert.
Technische Dokumentation
Ausführlichere Tutorials finden Sie hier Hier .