访问 ORCID 公共 API 需要一组由客户端组成的凭据 ID 和客户端机密。 本指南描述了获得 ORCID 公共 API 凭证。 ORCID 成员无需注册公共 API,因为可以使用他们的成员凭证。 要注册会员凭据,请参阅 注册客户端应用程序.
公共 API 凭证与个人的 ORCID 记录,不能转让给他人。 您需要同意 公共客户服务条款 在颁发证书之前。
组织 API 凭证可供支持 ORCID 通过付费会员订阅。 进一步了解 ORCID 籍.
我们建议开发人员在 沙盒测试服务器 在使用生产版本之前。
我们建议开发人员在 沙盒测试服务器 在使用生产版本之前。 以下是有关如何在沙盒和生产环境中注册公共 API 凭证的步骤。
- 登录你的 ORCID 记录:
生产服务器: https://orcid.org/signin
沙盒测试服务器: https://sandbox.orcid.org/signin - 在右上角点击你的名字
- 点击 开发者工具 从菜单选项
请注意: 为了访问开发人员工具,您必须验证您的电子邮件地址。 如果您尚未验证您的电子邮件地址,系统会提示您进行验证,然后才能注册公共 API 凭据 - 阅读并同意‘ORCID 公共客户服务条款
- 点击“注册 ORCID 公共 API 凭证”按钮。
填写申请详情表
- 注册公共 API 凭证后,您将被引导回开发人员工具(https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools).
- 您需要填写提交的申请详细信息表以注册新申请。
- 名字:您的应用程序的名称。 当用户授予您的应用程序权限以获取他们的权限时,这将显示给用户 ORCID iD,它将显示在他们的 受信任组织列表. 我们建议使用您的组织或服务的名称(例如期刊名称)。
- 申请网址: 用户可以访问该网站以了解有关您的应用程序的更多信息。 这也将显示在他们的 受信任组织列表.
- 应用说明:有关您正在开发的应用程序以及您将如何使用用户的应用程序的信息 ORCID ID。 这将在 OAuth 屏幕上向用户显示。
添加 重定向 URI
用户授权您的应用程序后,他们将返回到您指定的 URI。 您必须提前提供这些 URI,否则您的集成用户将遇到错误。
- 在提供的框中输入您的重定向 URI
- 如果您需要输入超过 1 个重定向 URI,请单击“添加另一个重定向 URI”
请注意:
- 只有 HTTPS URI 已在生产中接受
- 已注册的域 必须 与使用的域完全匹配,包括子域
- 尽可能完整注册所有重定向 URI。 这是最安全的选项,也是我们推荐的选项。 有关重定向 URI 的更多信息,请参阅我们的 重定向 URI 常见问题解答
保存您的申请
填写完申请表并添加重定向 URI 后,您可以保存您的申请。
- 单击“保存我的应用程序并生成我的客户端” ID 和秘密'
您将被引导回开发人员工具页面,该页面现在将包含您的公共 API 客户端凭据
更新您的凭据
更改您的申请信息非常简单。
- 编辑相关信息,然后点击“保存申请”
使用您的凭据
现在您已拥有凭据,是时候开始使用 ORCID 公共API!
请注意,如果您成为会员,我们可以将您的凭据传输到会员 API ORCID 会员 在未来。