Jedno ORCID Registr je navržen tak, aby uživatelé mohli poskytovat svá ID organizacím používajícím OAuth, což zajišťuje správnost iD se shromažďuje pro každého výzkumného pracovníka. Odrazujeme organizace od přidávání ORCID ID k jejich systémům na základě vyhledávání výzkumných pracovníků podle jména. Může však být užitečné zjistit, kolik výzkumných pracovníků ve vaší organizaci má ORCID ID, které lze provést pomocí API. Níže jsou uvedeny návrhy na vyhledávání podle organizace.
Úvod do vyhledávání, jak získat přístupový token, jak porozumět výsledkům vyhledávání a podrobnosti o dalších polích, která lze prohledat, najdete v našem Prohledávání výukového programu API v registru
Hledání podle jména a DOI
Při kontrole, zda jednotlivec má ORCID záznamu doporučujeme prohledat jak jejich jméno, tak DOI jedné nebo více z jejich nedávných prací. Výsledkem by měl být pouze záznam výzkumného pracovníka, kterého hledáte, a nikoli záznamy kohokoli jiného, kdo sdílí stejné jméno.
Ukázkové volání k vyhledání všech záznamů s názvem „Laurel Haak“ a buď DOI 10.1087 / 20120404 nebo 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
Hledání podle přidružení
Pole pro příslušnost lze vyhledávat buď pomocí názvu afilace, nebo pomocí jedinečného ROR ID nebo GRID ID organizace. (ID vaší organizace GRID najdete v GRID nebo vaše ROR ID v ROR registr)
Hledání podle názvu organizace
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"
Nebo pro přesnou shodu
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)
Hledání podle GRID ID
Příklad volání pro vyhledání všech záznamů s mřížkou ID GRID.5509.9 (University of 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
Hledat podle ROR ID
Příklad volání k vyhledání všech záznamů s 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"
Hledání podle e-mailové domény
Rozhraní API můžete použít k vyhledávání výzkumných pracovníků podle e-mailové domény. Pamatujte, že přibližně 97% e-mailových adres je v ORCID jsou soukromé a žádné záznamy se soukromou nebo důvěryhodnou e-mailovou adresou nebudou při tomto hledání vráceny.
Příklad volání pro vyhledání všech záznamů s e-mailovou adresou @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
Výsledky vyhledávání vrácené ve formátu CSV
Výsledky vyhledávání lze také vrátit ve formátu CSV. V rámci výzvy můžete určit výstupní sloupce ze seznamu dostupných polí níže:
orcid
e-mail
křestní jméno
rodinné jméno
křestní jména a příjmení
kreditní jméno
jiné jméno
název aktuální přidružení instituce
název minulé instituce-přidružení
Pomocí svých přihlašovacích údajů musíte určit záhlaví, které má být 'text / csv '. V rámci vyhledávacího volání musíte do dotazu přidat také pole, která požadujete na výstupu.
Hledání pouze pomocí vašeho prohlížeče
Hledání můžete dokončit také pomocí prohlížeče. Adresa URL je konstruována stejným způsobem, ale nemusíte používat žádná pověření API. Upozorňujeme, že toto lze dokončit pouze pomocí veřejného rozhraní API.
Níže je ukázkové volání pomocí veřejného API vyhledávání podle názvu organizace pomocí ORCID, křestní jména, příjmení, aktuální název přidružení instituce a název přidružení minulosti instituce jako požadovaný výstup.
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
Níže je uveden další příklad volání pomocí veřejného API vyhledávání podle různých variant názvu organizace.
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:("University of Plymouth" OR "Plymouth University")