Červenec označuje pátý měsíc od vydání ORCID API v2.0a jsme potěšeni, že můžeme oznámit, že mnoho uživatelů rozhraní Public a Member API již upgradovalo nebo je v procesu. Abychom povzbudili ty z vás, kteří ještě nezačali s upgradem, chtěli bychom zdůraznit některé funkce v2.0 které zjednoduší vaše pracovní postupy, zmenší velikost souborů pro přenos a vytvoří váš soubor ORCID integrace funguje lépe pro vás i pro vaše uživatele.
Méně rozsahů, méně zmatku
Naše staré API vám umožnilo požadovat spoustu oprávnění od uživatelů: oprávnění k vytváření položek v sekci, ke čtení stejné sekce a její aktualizaci. Výsledkem žádosti o samostatná oprávnění pro každou sekci byl seznam požadavků, které uživatele zmátly.
V API v2.0 máme sjednotil naše obory na tři, které vám umožňují požadovat (omezeně) čtení a aktualizovat přístup do všech sekcí ORCID záznam.
Stále máte tyto tokeny se staršími oprávněními? Nebojte se - budou i nadále pracovat na úrovních přístupu, pro které byly původně vydány. Ale možná budete chtít vytvořit pracovní postup a požádat uživatele, aby obnovili svá oprávnění, pokud váš upgradovaný systém obsahuje nové funkce zahrnující přístup k dalším částem jejich záznamu.
Číst a aktualizovat podle položek
Pokud váš systém potřeboval pomocí předchozích verzí API přidat novou samostatnou práci na záznam, ke kterému jste přidali více děl, musel aktualizovat celou sekci prací, včetně nové práce a všech dříve přidaných děl. Výsledkem bylo, že aktualizace jedné položky v záznamu zahrnovala odeslání potenciálně velkého souboru dalších položek, které neměly žádné změny, nebo ztrátu všech položek v této sekci nebo dokonce celého záznamu.
v2.0 zjednodušil tento proces o správa položek na individuální bázi. Váš systém může přidat jediné dílo do ORCID záznam, a poté upravit nebo odstranit toto jediné dílo. To se provádí implementací vložte kódy pro jednotlivé položky na ORCID Registr. Například pokud váš systém přidá nové zaměstnání k ORCID záznam, ORCID API vrátí potvrzovací zprávu spolu s put kódem, který váš systém může použít pouze k aktualizaci nebo odstranění dané položky. Obecně lze na jednu přidat, upravit nebo smazat pouze jednu položku ORCID záznam. Jedinou výjimkou jsou díla, které u mnoha vědců tvoří většinu jejich ORCID záznam. API v2.0 umožňuje vašim systémům přečíst až 50 děl najednou a do přidat až 100 děl včas. Úpravy nebo mazání děl musí být i nadále prováděny na základě položek.
Put kódy jsou zpětné: položkám přidaným v 1.2 a dřívějším byly přiřazeny put kódy. Při práci na upgradu systému na verzi 2.0 nezapomeňte přidat pole pro odpovídající put kód. Můžete se zeptat na ORCID zaznamenejte, abyste získali put kódy všech položek, které váš systém přidal do registru, a podle toho aktualizujte svou databázi, abyste je v budoucnu mohli podle potřeby aktualizovat.
Čtěte záznamy rychleji
API v2.0, stejně jako předchozí API, umožňuje vašemu systému přečíst jednu sekci nebo celý záznam v jediném volání. To, co se vrací, nebudou všechna data v záznamu, ale spíše souhrnný pohled na tři sekce, které bývají největší ORCID záznamy: práce, financování a vzájemná hodnocení.
Ať váš systém čte celý záznam nebo jednu část, souhrnné zobrazení z těchto aktivit se zobrazí. Souhrn obsahuje omezené informace: například souhrn prací vrací pouze pracovní název, typ, datum, jeho jedinečné identifikátory a jejich vztah k dílu, index zobrazení pro každou verzi položky (pokud existuje více verzí), zdroj (uživatel nebo klient API) a odpovídající put kód pro každou verzi položky.
Souhrnná zobrazení snižují velikost souborů a doby přenosu, snižují potenciální zátěž pro náš i váš systém a urychlují aktualizace.
A ještě mnohem víc!
Ve verzi 2.0 je mnohem víc, z čeho byste měli být šťastní: flexibilní podpora externích identifikátorů, přidání aktivit vzájemného hodnocení, jasnější seskupení více verzí aktivit, ve výchozím nastavení lepší výsledky vyhledávání a další.
Chcete se dozvědět více? Připoj se k nám! Každý měsíc pořádáme webináře ve více časových pásmech a jazycích a po zbytek roku budeme diskutovat o upgradu na API v2.0. Podívejte se na naše výpisy pro dalšínebo kontaktujte nás dozvědět se více.
Už jste upgradovali na API v2.0? Sdělte nám své zkušenosti!