と対話する許可を要求するとき ORCID ユーザーのレコードでは、XNUMXつ以上の「スコープ」を指定します。 各スコープを使用すると、レコードの読み取りや特定のセクションの更新など、特定のことを実行できます。
3本足（認証コード）スコープ
3脚 ユーザーからの許可の取得に関与するXNUMX人のアクターを指します。 ORCID、システムとユーザー自身。
/認証する 
このスコープは、 ORCID iD 記録上の公開情報のみを読んでください。 他のすべての3脚スコープには認証権限が含まれているため、他のアクセスを要求する場合は、このスコープを省略できます。 このスコープは、メンバーAPIまたはパブリックAPIで使用できます。
/ read-limited（メンバーAPIのみ） 
このスコープは、公開されている可視性のアイテムを読み取るためのアクセス権を取得するために使用されます。 ORCID 記録。 このスコープは、メンバーAPIでのみ使用できます。
/ Activities / update（メンバーAPIのみ） 
このスコープは、所属、資金提供、研究、研究リソース、およびピアレビューセクションの項目を作成、更新、削除するために使用されます。 ORCID 記録。 このスコープは、メンバーAPIでのみ使用できます。
/ person / update（メンバーAPIのみ）
このスコープは、レコードの他の名前、キーワード、国、研究者のURL、Webサイト、および個人の外部識別子セクションの項目を書き込み、更新、および削除するために使用されます。 このスコープは、メンバーAPIでのみ使用できます。
オープンID
このスコープは、id_tokenが必要な場合にOpenIDインテグレーターによって使用されます。 openidスコープが含まれている場合、レジストリはトークン応答内にid_tokenを返し、そのユーザーのユーザー情報エンドポイントにアクセスするためのアクセス許可をクライアントに付与します。 このスコープは、パブリックAPIとメンバーAPIで利用できます。
'openid'スコープは他のように '/'で始まらないことに注意してください ORCID APIスコープ。 これは、「openid」スコープがによって定義されていないためです。 ORCID、ただし、代わりにOpenIDConnect仕様で定義されています。 ご覧ください OpenIDドキュメント を参考にしてください。
複数のスコープ
scope = / read-limited％20 / Activities / update％20 / person / updateのように、認証URLのスコープをそれぞれの間にエンコードされたスペースでリストすることにより、XNUMX回の対話で複数のスコープを要求できます。
完全なアクセス
レコードを読み取って編集するためのフルアクセスが必要な場合は、認証URLに/ read-limited、/ activitys / update、および/ person / updateの20つのスコープを含めます。 URLでは、scope = / read-limited％20 / Activities / update％XNUMX / person / updateとして表示されます。
2本足（クライアントクレデンシャル）スコープ
一部のアクティビティでは、ユーザーに許可を求める必要はありません。 XNUMXつのレッグOAuthスコープがから直接要求されます ORCID APIであり、研究者が許可を与える必要はありません。 これらのスコープを持つトークンは20年間有効であり、再利用できます
/ read-public
このスコープは、単一の公開情報を読み取るために使用されます ORCID iD またはを検索 ORCID 記録。 このスコープは、メンバーAPIまたはパブリックAPIで使用できます。
/ webhook
このスコープにより、クライアントアプリケーションはWebhookを ORCID レコード、レコードが更新されたときに通知を受信するため。 このスコープはプレミアムで利用可能です ORCID メンバーのみ。 プレミアムメンバーではないが、開発者のサンドボックスでこの機能をテストしたい場合は、 接触 ORCID コミュニティ.
- 過去には ORCID 現在サポートされている他のスコープをサポート 段階的に廃止.
- あなたは見つけることができます ここで特定のセクションを追加または更新するために必要なスコープ.