XNUMX月は 発売からXNUMXヶ月 ORCID API v2.0、およびPublicおよびMember APIの多くのユーザーがすでにアップグレードしているか、アップグレードの過程にあることを報告できることをうれしく思います。 まだアップグレードを開始していない方を励ますために、強調したいと思います v2.0の機能の一部 これにより、ワークフローが簡素化され、転送ファイルのサイズが小さくなり、 ORCID 統合は、あなたとあなたのユーザーの両方にとってより良く機能します。
スコープが少なくなり、混乱が少なくなります
私たちの古いAPIを使用すると、多くのリクエストを行うことができます ユーザーからの権限:セクションにアイテムを作成し、同じセクションを読み取り、更新する権限。 セクションごとに個別の権限をリクエストすると、ユーザーを混乱させるリクエストのリストが作成されました。
API v2.0では、 スコープを統合 XNUMXつに、これにより、のすべてのセクションへの読み取り(制限付き)および更新アクセスを要求できます。 ORCID 記録。
古い権限でそれらのトークンをまだ持っていますか? 心配しないでください。最初に発行されたアクセスレベルで引き続き機能します。 ただし、アップグレードしたシステムにレコードの他のセクションへのアクセスを含む新機能がある場合は、ワークフローを組み込んで、ユーザーにアクセス許可の更新を要求することをお勧めします。
アイテムごとに読んで更新する
以前のバージョンのAPIを使用して、システムが複数の作品を追加したレコードに新しい単一の作品を追加する必要がある場合、新しい作品と以前に追加されたすべての作品を含む作品セクション全体を更新する必要がありました。 その結果、レコード上のXNUMXつのアイテムを更新するには、変更のない他のアイテムの潜在的に大きなファイルを送信するか、そのセクションのすべてのアイテム、またはレコード全体を失う必要がありました。
v2.0は、このプロセスを次のように簡素化しました。 個別にアイテムを管理する。 あなたのシステムはできます に単一の作品を追加します ORCID 記録、次にその単一の作品を編集または削除します。 これは、実装することによって行われます コードを入れる 上の個々のアイテムの場合 ORCID レジストリ。 たとえば、システムが新しい雇用提携をに追加する場合 ORCID 記録、 ORCID APIは、システムがそのアイテムのみを更新または削除するために使用できるプットコードとともに確認メッセージを返します。 一般に、一度にXNUMXつのアイテムのみを追加、編集、または削除できます。 ORCID 記録。 唯一の例外は作品です、多くの研究者にとって、それは彼らの大部分を占めています ORCID 記録。 API v2.0を使用すると、システムで次のことが可能になります。 最大50作品を読む 一度に、そして 最大100作品を追加 一度に。 作品の編集または削除は、引き続きアイテムごとに行う必要があります。
プットコードは遡及的です。1.2以前で追加されたアイテムにはすべてプットコードが割り当てられています。 システムをv2.0にアップグレードするときは、対応するプットコードのフィールドを追加することを忘れないでください。 あなたはクエリすることができます ORCID システムがレジストリに追加したアイテムのプットコードを取得するために記録し、それに応じてデータベースを更新して、将来必要に応じてそれらを更新できるようにします。
レコードをより速く読む
API v2.0は、以前のAPIと同様に、システムで次のことを実行できます。 XNUMX回の呼び出しでXNUMXつのセクションまたはレコード全体を読み取る。 返されるのは、レコード上のすべてのデータではなく、で最大になる傾向があるXNUMXつのセクションの要約ビューです。 ORCID 記録:作品、資金提供、ピアレビュー。
システムがレコード全体を読み取る場合でも、単一のセクションを読み取る場合でも、 概要ビュー これらのアクティビティのが表示されます。 要約には限られた情報が含まれます。たとえば、作品の要約は、作品のタイトル、タイプ、日付、一意の識別子と作品との関係、アイテムの各バージョンの表示インデックス(複数のバージョンがある場合)のみを返します。ソース(ユーザーまたはAPIクライアント)およびアイテムの各バージョンに対応するプットコード。
サマリービューは、ファイルサイズと転送時間を削減し、システムとユーザーの潜在的な負担を軽減し、更新を高速化します。
そしてそれ以上のこと!
v2.0には、満足できることがたくさんあります。:外部識別子の柔軟なサポート、ピアレビューアクティビティの追加、アクティビティの複数のバージョンのより明確なグループ化、デフォルトでの検索結果の拡大など。
詳細を知りたいですか? 参加しませんか! 毎月、複数のタイムゾーンと言語でウェビナーを開催し、今年の残りの期間はAPIv2.0へのアップグレードについて話し合います。 次のもののために私たちのリストをチェックしてくださいまたは Rescale Support to learn more.
すでにAPIv2.0にアップグレードしましたか? あなたの経験を教えてください!