授权 Rememberizer 应用

Rememberizer 的实现支持标准的 授权码授权类型

授权用户使用您的应用的网络应用流程如下:

  1. 用户被重定向到 Rememberizer 以授权他们的账户。

  2. 用户选择要与您的应用一起使用的纪念品。

  3. 您的应用使用用户的访问令牌访问 API。

访问 管理第三方应用 页面以查看该流程的 UI 示例。

即将推出:OAuth2 授权流程图

该序列图将展示以下各方之间完整的 OAuth2 流程:

  • 用户的浏览器

  • 您的应用(客户端)

  • Rememberizer 授权服务器

  • Rememberizer API 资源

该图将展示在流程的所有步骤中授权码、令牌和 API 请求的交换。

步骤 1. 请求用户的 Rememberizer 身份

将用户重定向到 Rememberizer 授权服务器以启动身份验证和授权过程。

GET https://api.rememberizer.ai/api/v1/auth/oauth2/authorize/

参数:

名称
描述

client_id

必填 您应用程序的客户端 ID。您可以在开发者中找到此值。点击左上角的 开发者。在注册应用程序列表中,点击您的应用程序,您将在 应用凭据 中看到客户端 ID。

response_type

必填 必须为 code 以获取授权码。

scope

可选

一个以空格分隔的作用域列表,标识您的应用程序可以代表用户访问的资源。

redirect_uri

必填 用户授权后将被发送到您应用程序中的 URL。

state

必填

客户端用于在请求和回调之间保持状态的一个不透明值。授权服务器在将用户代理重定向回客户端时包含此值。

步骤 2. 用户选择并配置他们的纪念品

用户将选择与您的应用一起使用的纪念品。

第 3 步。用户通过 Rememberizer 被重定向回您的网站

在用户选择他们的纪念品后,Rememberizer 会将用户重定向回您的网站,并带有一个临时的 code 参数以及您在上一步中提供的 state 参数。临时代码将在短时间后过期。如果状态不匹配,则请求是由第三方创建的,您应该中止该过程。

第 4 步. 交换授权码以获取刷新和访问令牌

POST https://api.rememberizer.ai/api/v1/auth/oauth2/token/

此端点接受以下输入参数。

名称
描述

client_id

必填 您应用程序的客户端 ID。您可以在开发者中找到此值。查找此 ID 的说明在第 1 步中。

client_secret

必填 您从 Rememberizer 收到的应用程序客户端密钥。

code

您在第 3 步中收到的授权码。

redirect_uri

必填 用户在授权后被发送到您应用程序中的 URL。必须与第 1 步中的 redirect_uri 匹配。

第 5 步. 使用访问令牌访问 API

访问令牌允许您代表用户向 API 发出请求。

Authorization: Bearer OAUTH-TOKEN
GET https://api.rememberizer.ai/api/me/

例如,在 curl 中,您可以这样设置 Authorization 头:

curl -H "Authorization: Bearer OAUTH-TOKEN" https://api.rememberizer.ai/api/me/

参考资料

Github: https://github.com/skydeckai/rememberizer-integration-samples

Last updated