Le ORCID Il registro è progettato per consentire agli utenti di fornire i propri ID alle organizzazioni che utilizzano OAuth, il che garantisce che il corretto iD viene raccolto per ogni ricercatore. Scoraggiamo le organizzazioni dall'aggiungere ORCID iD ai loro sistemi basati su una ricerca di ricercatori per nome. Tuttavia, può essere utile scoprire quanti ricercatori hanno nella tua organizzazione ORCID iD, che possono essere eseguiti tramite l'API. Di seguito vengono forniti suggerimenti per la ricerca per organizzazione.
Per un'introduzione alla ricerca, come ottenere un token di accesso, come comprendere i risultati della ricerca e i dettagli di altri campi in cui è possibile eseguire la ricerca, consultare il nostro Esercitazione sulla ricerca dell'API del registro
Ricerca per nome e DOI
Quando si controlla se un individuo ha un has ORCID record, consigliamo di cercare sia per nome che per DOI di uno o più dei loro lavori recenti. Ciò dovrebbe comportare solo il record del ricercatore che stai cercando e non i record di chiunque altro condivida lo stesso nome.
Un esempio di chiamata per cercare tutti i record con il nome "Laurel Haak" e il DOI 10.1087/20120404 o il 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
Ricerca per affiliazione
I campi di affiliazione possono essere ricercati utilizzando il nome dell'affiliazione o l'ID ROR o l'ID GRID univoco dell'organizzazione. (È possibile trovare l'ID GRID della propria organizzazione in GRID o il tuo ID ROR nel Registro ROR)
Cerca per nome dell'organizzazione
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"
O per una corrispondenza esatta
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)
Ricerca per ID GRIGLIA
Un esempio di chiamata per cercare tutti i record con ID GRID grid.5509.9 (Università di 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
Ricerca per ID ROR
Un esempio di chiamata per cercare tutti i record con l'ID ROR 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"
Cerca per dominio di posta elettronica
Puoi utilizzare l'API per cercare ricercatori per dominio di posta elettronica. Tieni presente che circa il 97% degli indirizzi email in ORCID sono privati e tutti i record con un indirizzo e-mail privato o con accesso sicuro non verranno restituiti in questa ricerca.
Un esempio di chiamata per cercare tutti i record con un indirizzo email @orcid.org:
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
Risultati della ricerca restituiti in formato CSV
I risultati della ricerca possono essere restituiti anche in formato CSV. Come parte della chiamata è possibile specificare le colonne di output da un elenco di campi disponibili di seguito:
orcida
email
nome di battesimo
cognome
dati-e-cognomi
nome-credito
altro nome
nome-affiliazione-istituto-attuale
nome-affiliazione-istituto-passato
Utilizzando le tue credenziali è necessario specificare l'intestazione come "testo/csv'. Come parte della chiamata di ricerca, è necessario aggiungere alla query anche i campi richiesti nell'output.
Ricerca usando solo il tuo browser
Puoi anche completare la ricerca utilizzando il tuo browser. L'URL è costruito allo stesso modo, ma non è necessario utilizzare alcuna credenziale API. Si prega di notare che questo può essere completato solo utilizzando l'API pubblica.
Di seguito è riportato un esempio di chiamata utilizzando l'API pubblica che effettua la ricerca per nome dell'organizzazione con ORCID, nomi, cognomi, nome di affiliazione dell'istituto attuale e nome di affiliazione dell'istituto passato come output desiderato.
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
Di seguito è riportato un altro esempio di chiamata che utilizza l'API pubblica che esegue la ricerca in base a diverse varianti del nome dell'organizzazione.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:("University of Plymouth" OR "Plymouth University")