如何获取 Rows 开放平台 API 密钥（分步指南）

在现代数据处理和业务分析中，快速与实时集成不同数据源的能力至关重要。Rows 开放平台为开发者提供了强大的工具，使他们能够轻松管理电子表格中的数据，实现动态的数据读取与写入功能。通过使用 Rows 开放平台API，用户可以自动化数据流，支持跨团队协作并优化业务流程。本文将指导你如何获取Rows 开放平台API密钥，并进行初步的可用性测试，同时探讨在使用过程中需要考虑的其他关键因素。

1. 获取Rows 开放平台 API秘钥步骤

获取Rows 开放平台 API密钥的过程相对简单，只需几个步骤即可完成：

1.访问官方网站注册/登录：https://rows.com/auth/sign-up?utm_source=other&utm_campaign=ai

2.登录成功以后会进入仪表盘页面，点击左上角头像，找到设置

3.进入设置页面以后，点击左侧导航栏中的Rows API，在这里会看到密钥相关信息。

4.点击新的API密钥创建密钥，创建成功以后会在页面中显示。（提示：一定要保存好密钥，不要泄露）

2. Rows 开放平台 API密钥可用性测试

在获取API密钥后，进行可用性测试是确保其正常工作的重要步骤。以下是使用curl进行测试的一个案例

以下接口为Rows 开放平台接口中的获取工作区文件夹信息接口

输入：

curl --location --request GET 'https://api.rows.com/v1/folders?offset=0&limit=100' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {YOUR API TOKEN}'

输出：

你将得到一个JSON格式的响应，其中包含了文件夹的详细信息。

[
{
  "items": [
    {
      "id": "7cbc1000-8141-11ed-a1eb-0242ac120002",
      "name": "Board meetings reports",
      "slug": "board-meetings-reports"
    },
    {
      "id": "82c3fa30-8141-11ed-a1eb-0242ac120002",
      "name": "My finance reports",
      "slug": "my-finance-reports"
    }
  ],
  "next_page_results": "v1/folders?offset=100&limit=100"
}
]

3. 使用Rows 开放平台 API搭建应用的其他关键考虑因素

在使用Rows 开放平台 API搭建应用时，除了获取和测试API密钥外，还需考虑以下因素：

认证与授权

Rows API 使用基于令牌的身份验证。

您的所有请求都需要 HTTP 授权承载令牌标头，如下所示：Authorization: Bearer {your-api-key}

要管理 API 密钥，请转到您的工作区设置。 API 密钥可由相应所有者以及工作区所有者或管理员撤销。每个用户最多可为每个工作区创建 10 个 API 密钥。

目前，只有工作区管理员和所有者才能访问工作区设置，因此，只有他们才能管理 API 密钥。

错误处理

Rows API 依赖标准HTTP 代码对操作结果进行分类。当返回错误时，代码和相应的消息将被编码在响应中。下面是一个错误示例：

{
"code": 404,
"message": "Workspace not found."
}

下面列出了可能的错误状态代码：

HTTP 状态代码	状态名称	意义
400	错误的请求	请求无效。 `message`字段会注明具体原因
401	未经授权	API 密钥丢失或无效。
403	禁止	您无权访问该资源。请与工作区管理员检查权限。
404	未找到	该资源不存在。
429	请求过多	您超出了速率限制。查看我们有关速率限制器的文档。
500	服务器内部错误	服务器发生错误，导致您的请求无法完成。如果问题仍然存在，请联系我们。