分类

XLSX API 写入 Sheet

将 REST/GraphQL 返回的 JSON 自动分页并映射写入 Excel Sheet

支持多种分页策略、字段映射、REST 与 GraphQL。

示例结果

1 个示例

导出 Elysia Tools API 到 Sheet

从 Elysia Tools 接口读取工具列表并映射到 Excel

workbook-sales.xlsx 查看文件
查看输入参数
{ "sourceType": "rest", "url": "https://elysiatools.com/zh/api/tools", "method": "GET", "dataPath": "tools", "paginationType": "none", "fieldMapping": "{\n \"id\": \"id\",\n \"name\": \"name\",\n \"category\": \"category\",\n \"result_type\": \"resultType\",\n \"featured\": \"featured\",\n \"last_updated\": \"lastUpdated\"\n}", "sheetName": "Tools API" }

关键信息

分类
Format Conversion
输入类型
select, text, textarea, number
输出类型
file
样本覆盖
4
支持 API
Yes

概览

XLSX API 写入 Sheet 工具是一款高效的数据集成助手,旨在帮助用户将 REST 或 GraphQL 接口返回的 JSON 数据自动分页抓取,并根据自定义字段映射规则直接生成 Excel 文件,简化从 API 到表格的数据处理流程。

适用场景

  • 需要定期从业务系统 API 导出大量数据并整理为 Excel 报表时。
  • 接口数据量较大,需要通过分页(页码、偏移或游标)自动获取完整数据集时。
  • API 返回的原始 JSON 结构复杂,需要提取特定字段并重命名以符合报表格式时。

工作原理

  • 配置 API 地址、请求方法及必要的请求头或查询参数。
  • 根据接口特性选择分页策略(如页码、偏移量或游标),并设置最大抓取页数。
  • 通过字段映射 JSON 定义 API 响应路径与 Excel 列名的对应关系。
  • 执行任务,工具将自动请求数据并生成包含映射结果的 Excel 文件。

使用场景

电商运营:自动抓取后台商品库存接口,生成每日库存盘点表。
市场分析:通过 GraphQL 批量获取社交媒体互动数据,并整理为分析报表。
财务对账:从支付网关 API 拉取交易流水,映射为财务部门要求的对账格式。

用户案例

1. 导出工具列表至 Excel

数据分析师
背景原因
需要将公司内部工具平台的 API 数据导出,以便进行离线统计分析。
解决问题
手动复制 JSON 数据并转换为表格非常繁琐且容易出错。
如何使用
设置 API 地址为工具列表接口,选择 REST GET 方法,配置字段映射以提取 ID、名称和分类。
示例配置
{"id": "id", "name": "name", "category": "category", "result_type": "resultType"}
效果
生成一份包含所有工具详细信息的 Excel 文件,字段已按要求自动对齐。

用 Samples 测试

json, xlsx, xls

相关专题

常见问题

该工具支持哪些类型的 API?

支持标准的 REST API(GET/POST/PUT/PATCH)以及 GraphQL 查询接口。

如何处理分页数据?

工具内置了页码、偏移量(Offset)和游标(Cursor)三种分页模式,可根据接口文档配置对应的参数名和起始值。

字段映射功能如何使用?

通过 JSON 格式配置映射关系,例如 {"Excel列名": "API响应中的路径"},支持嵌套路径提取。

最大支持抓取多少页数据?

默认最大支持 50 页,您可以根据实际需求在配置中调整该数值。

生成的 Excel 文件可以自定义工作表名称吗?

可以,您可以在配置项中指定工作表名称(默认为 API Data)。

API 文档

请求端点

POST /zh/api/tools/xlsx-api-to-sheet

请求参数

参数名 类型 必填 描述
sourceType select -
url text -
method select -
headers textarea -
queryParams textarea -
body textarea -
graphqlQuery textarea -
graphqlVariables textarea -
dataPath text -
paginationType select -
maxPages number -
pageParam text -
pageStart number -
pageSizeParam text -
pageSize number -
offsetParam text -
offsetStart number -
cursorParam text -
cursorStart text -
hasMorePath text -
nextCursorPath text -
totalPagesPath text -
fieldMapping textarea -
sheetName text -
outputFileName text -

响应格式

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
文件: 文件

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-xlsx-api-to-sheet": {
      "name": "xlsx-api-to-sheet",
      "description": "将 REST/GraphQL 返回的 JSON 自动分页并映射写入 Excel Sheet",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-api-to-sheet",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

如果遇见问题,请联系我们:[email protected]