授权码

授权码是授权服务器授权的临时码.您可以获得访问令牌以换取授权码.获得访问令牌后,您可以使用它来访问资源或代表用户执行操作.

在 Appsmith 中, 您可以通过设置 Authenticated API 并将其配置为将 Authorization Code 用作授权类型来实现此目的.

与 Dropbox 集成

让我们通过一个例子来了解授权码与 Dropbox 的集成.您有一个基于 Appsmith 构建的门户应用程序,您的应用程序用户使用它来上传他们的个人资料.您已经有一个与 Dropbox 集成的后端应用程序,并希望使用 Dropbox 来存储配置文件.为此,您必须创建一个经过身份验证的 API 并将其配置为与 Dropbox 连接.

用户端点

您必须连接到 Dropbox 平台上的用户端点才能执行 API 调用.导航到Dropbox 用于不同 API 调用 exhaustive list of user endpoints.

Dropbox 提供 有关 您必须添加到请求中的标题或内容类型的详细信息.

配置经过身份验证的 API

上传文件配置 Authenticated API 如下表:

Appsmith	Dropbox	Value
URL	User Endpoint	https://content.dropboxapi.com/
Headers	Dropbox-API-Arg	{"path": "/{{<pick the file path from widget like`` ****` FilePicker**>**}}","mode" : "add","autorename" : true, "mute" : false,"strict_conflict" :false}`
Headers	Content-Type	application/octet-stream
Authentication Type	NA	OAuth 2.0
Grant Type	NA	Authorization Code
Access Token URL	Token Endpoint	https://api.dropboxapi.com/oauth2/token
Client ID	Navigate to Appconsole >> Select App >> Settings tab >> App key	Copy the App key and add in the Client ID field.
Client Secret	Navigate to Appconsole >> Select App >> Settings tab >> App secret	Copy the App secret and add in the Client secret field.
Scopes	Navigate to Appconsole >> Select App >> Permissions tab >> select Scope file.content.write	Copy the scope files.content.write and add it to the field.
Authorization URL	Authorization Endpoint	https://www.dropbox.com/oauth2/authorize
Redirect URL	Navigate to Appconsole >> Select App >> Settings tab >> OAuth2 >> Redirect URIs	Add the Redirect URL from Appsmith to the field and click add button.

要创建应用程序,您还可以遵循 Dropbox 提供的 OAuth guide .

保留其余设置并单击 Save and Authorize 按钮.您将被重定向到 Appsmith 上的数据源屏幕,响应状态为成功验证成功.

您可以通过查看浏览器地址栏中的来验证您的数据源验证是否成功 response_status

上传文件

用户将使用 Filepicker 小部件选择文件.每当用户选择文件并点击上传时,该按钮将触发上传文件的 API 调用.下面是 Portal App 和 Dropbox 交互的蓝图:

1. 用户选择一个文件并单击上传按钮.

2. 在 Appsmith 上的人将被调用 Upload API

3. 与 Authenticated API Dropbox API 对话以进行授权和生成令牌.生成的令牌将添加到上传 API 调用.

4. 上传请求在 Dropbox 上执行以上传文件.

5. Dropbox目录结构显示文件上传成功.

您可以将响应全部发送到 Portal App 以显示上传的文件或将其绑定以向亲密用户显示消息以成功上传.

让我们配置 Authentication API 以与 Dropbox 集成并创建上传文件的工作流程.

创建查询

导航到 Explorer → 单击查询/API 旁边的 (+) 在 创建查询下选择. New <AuthenticatedAPIName> Query

该操作为 Dropbox 添加了一个连接到数据源 (AuthenticatedAPI) 的 API.您将看到您为数据源配置的用户端点以及标头详细信息已经可用.

有两种方法可以将标头添加到 API:

将标头添加到经过身份验证的 API

您可以在配置时直接将标头添加到 Authenticated API.您可以在此处添加跨 API 通用的标头.例如,内容类型.

向 API 添加标头

当您将它们添加到平台时,您可以将标头添加到各个 API.您可以在此处添加特定于 API 的标头.

添加小部件

让我们在画布上添加一个文件选择器小部件并将其配置为触发 Upload API 调用.

• 导航到小部件 → 在搜索栏中搜索 FilePicker 将小部件拖到画布上.

• 选择 FilePicker 小部件并导航到 onFilesSelected 属性窗格中可用的事件.

• 启用事件旁边可用的 JS

• 在输入框中添加以下代码.

{{UploadFileToDropbox.run() }} 

每当 FilePicker 小部件选择文件并且用户单击小部件上可用的上传按钮时,上述代码片段将触发 API 执行.

在任何给定的时间点,您都可以使用小胡子 {{}} 符号将数据添加到标题中.例如, FilePicker1.files[0].name 对于文件名.

一旦 API 调用成功,您可以导航到 Dropbox 界面并验证文件上传.

与 Google 文档集成

让我们看看您可以使用 Authenticated API 进行的其他一些集成.在本节中,您将能够配置您的 Google Docs 集成到您的 Appsmith 应用程序.

用户端点

您必须连接到 Google Docs 平台上的用户端点才能执行 API 调用.Google Docs 提供了与 Docs API 集成的详尽指南.

配置身份验证 API

按照以下步骤为经过身份验证的 API 配置 Google 文档集成.

Appsmith	Google Docs	Value
URL	User Endpoint	https://docs.googleapis.com/
Authentication Type	NA	OAuth 2.0
Grant Type	NA	Authorization Code
Access Token URL	Token Endpoint	https://oauth2.googleapis.com/token
Client ID	Navigate to Google API Console >> Select Your Project that has Google Docs API Enabled >> Select Google API Docs on API/Service Details >> Click on Client Credentials >> Select the OAuth 2.0 Client >> Copy Client ID	Copy the Client ID and add in the Client ID field.
Client Secret	Navigate to Google API Console >> Select Your Project that has Google Docs API Enabled >> Select Google API Docs on API/Service Details >> Click on Client Credentials >> Select the OAuth 2.0 Client >> Copy Client Secret	Copy the Client secret and add in the Client secret field.
Scopes	Navigate to Google API doc >>Click the API you are integrating with for example (create) >> on the right Panel >> Try this method >> scroll to the show scopes link >> click on the link to reveal the scopes required for the API.	https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive
Authorization URL	Authorization Endpoint	https://accounts.google.com/o/oauth2/auth
Redirect URL	Navigate to Google API Console >> Select Your Project that has Google Docs API Enabled >> Select Google API Docs on API/Service Details >> Click on Client Credentials >> Select the OAuth 2.0 Client >>Authorized redirect URIs	Add the Redirect URL from Appsmith to the field and click the save button.

您可以按照 Google 提供的分步指南设置 OAuth 2.0 客户端.

保持其他设置不变,然后单击 Save & Authorize 按钮创建 Authenticated API.系统会要求您登录您的 Google 帐户并授权数据源.成功通过身份验证后,您将导航到 Appsmith 数据源屏幕,地址栏中显示响应状态.成功的响应状态标志着数据源的成功配置

添加数据源后,您可以使用 google docs 界面创建查询并执行不同的操作.

您还可以查看操作指南- 如何添加 OAuth2 授权以将 Google 表格集成 到 Appsmith.

与 Zoho Campaigns 集成

让我们看看您可以使用 Authenticated API 进行的另一个集成.在本部分中,您将能够配置您的 Appsmith 应用程序以与 Zoho Campaigns 集成.

用户端点

您必须连接到 Zoho Campaigns 平台上的用户端点才能执行 API 调用.Zoho Campaigns 为 与 Campaign API 集成提供了详尽的开发人员指南.

配置经过身份验证的 API

按照以下步骤配置 Zoho Campaigns 的已验证 API 集成.

Zoho API 是特定于位置的,即,如果您的组织位于美国 (US),那么您使用的 API 端点应该特定于.com 域.例如,如果你的组织位于美国,将使用 https://campaigns.zoho.com/ 每当你在认证的API中配置URL时Authenticated API,要验证你的组织的位置.

Appsmith	Zoho Campaigns	Value
URL	User Endpoint	https://campaigns.zoho.in/api
Authentication Type	NA	OAuth 2.0
Grant Type	NA	Authorization Code
Access Token URL	Token Endpoint	https://accounts.zoho.in/oauth/v2/token
Client ID	Navigate to Zoho API Console>> Select Your Application >> Select Client Secret Tab>> Copy Client ID	Add it to the Client ID field on Appsmith.
Client Secret	Navigate to Zoho API Console>> Select Your Application >> Select Client Secret Tab>> Copy Client Secret	Add it to the Client secret field on Appsmith.
Scopes	Navigate to the Zoho Campaign guide and click on the API you want to integrate with and check the scope required.	Zohocampaigns.campaign.ALL
Authorization URL	Authorization Endpoint	https://accounts.zoho.in/oauth/v2/auth
Redirect URL	Navigate to Zoho API Console>> Select Your Application >> Select Client Details>> Authorized Redirect URIs	Add the Redirect URL from Appsmith to the field and click the Update button.

您可以按照 Zoho 提供的分步指南来 注册客户端.

对上述字段进行更改后,单击 Save & Authorize 按钮以创建 Authenticated API.您将被要求通过登录 Zoho 账户来授权数据源.您将被导航到 Appsmith 数据源屏幕,并在成功验证的地址栏中显示成功响应状态.

添加数据源后,您可以使用 Zoho Campaign 界面创建查询并执行不同的操作.

其他设置

除了必需的设置外,还有一些可选设置已设置默认值,如果需要,您可以更改配置:

自定义身份验证参数

如果您的授权服务器需要您发送一些自定义查询参数作为访问令牌请求的一部分,您可以在此处添加这些参数.您可以根据需要添加一个或多个参数.例如,您的 API 需要一个 showPrompt 发送到授权服务器的参数,并且基于该参数,您的 API 逻辑要么向用户提示接受同意,要么不显示提示,因为已经记录了同意.在这种情况下,您可以将该 showPrompt 参数配置为自定义参数.

客户端认证

如果您的 API 需要发送客户端凭据,那么您可以使用客户端身份验证字段.您可以选择将客户端凭据作为以下内容的一部分发送:

• 通过选择作为 Basic Auth Header 发送的基本授权标头.

• 通过选择在正文中发送客户端凭据,以客户端凭据的形式发送正文.

高级设置

您可以将一些高级设置配置为 Authenticated API 的一部分.

使用刷新令牌发送范围

使用此配置,您可以选择发送为 API 配置的范围以及刷新令牌.默认情况下,该设置处于关闭状态.您可以通过选择 Yes 打开设置.

使用（在刷新令牌上）发送客户端凭据

您可以通过配置此字段来选择发送客户端凭据以及刷新令牌.您可以通过选择 header 来选择将客户端凭据作为 header 的一部分发送,或者通过选择body 来选择作为 body 的一部分发送

通过 OAuth 2.0 集成,您可以将 API 连接到 Appsmith 并构建复杂的应用程序.