# XLSX API 写入 Sheet

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

> 标准页面: https://elysiatools.com/zh/tools/xlsx-api-to-sheet

- **分类:** Format Conversion

- **关键词:** xlsx, api, rest, graphql, pagination, json, mapping

## 概述

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

## 输入项

- **数据源类型** (select)
- **API 地址** (text): https://api.example.com/items
- **REST 方法** (select)
- **请求头 JSON** (textarea): {"Authorization":"Bearer xxx"}
- **查询参数 JSON** (textarea): {"status":"active"}
- **REST 请求体 JSON** (textarea): {"filters":{"status":"active"}}
- **GraphQL 查询** (textarea): query($page:Int,$limit:Int){ items(page:$page,limit:$limit){ id name } }
- **GraphQL 变量 JSON** (textarea): {"status":"active"}
- **数据路径** (text): data.items
- **分页类型** (select)
- **最大页数** (number)
- **页码参数** (text)
- **起始页** (number)
- **页大小参数** (text)
- **每页数量** (number)
- **偏移参数** (text)
- **起始偏移** (number)
- **游标参数** (text)
- **初始游标** (text)
- **是否有下一页路径** (text): data.pageInfo.hasNextPage
- **下一游标路径** (text)
- **总页数路径** (text): meta.totalPages
- **字段映射 JSON** (textarea): {"customer":"data.customer.name","amount":"amount"}
- **工作表名** (text)
- **输出文件名** (text): api-export

## 适用场景

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

## 工作原理

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

## 使用案例

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

## 常见问题

### 该工具支持哪些类型的 API？

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

### 如何处理分页数据？

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

### 字段映射功能如何使用？

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

### 最大支持抓取多少页数据？

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

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

可以，您可以在配置项中指定工作表名称（默认为 API Data）。

## 相关工具

- [文本转Excel转换器](https://elysiatools.com/zh/tools/text-to-excel): 将各种文本格式转换为Excel，支持自定义解析和格式化选项
- [XLSX 图表嵌入器](https://elysiatools.com/zh/tools/xlsx-chart-embedder): 从工作簿数据区域生成柱状图/饼图图片并嵌入 Excel 工作表
- [XLSX 条件格式规则器](https://elysiatools.com/zh/tools/xlsx-conditional-formatting-rule): 批量应用 Excel 条件格式，如阈值标红、数据条与色阶
- [XLSX JSON 双向转换器](https://elysiatools.com/zh/tools/xlsx-json-transformer): JSON数组与Excel表格双向转换，支持嵌套对象打平与还原
- [XLSX 多 Sheet 拆分器](https://elysiatools.com/zh/tools/xlsx-multi-sheet-splitter): 将多 Sheet 工作簿拆分为多个独立文件
- [XLSX Parquet 导出器](https://elysiatools.com/zh/tools/xlsx-parquet-exporter): 将表格导出为 Parquet/NDJSON，用于大数据与数据仓库管道
- [XLSX 打印设置打包器](https://elysiatools.com/zh/tools/xlsx-print-setup-pack): 一键设置纸张、边距、缩放、重复标题行和页眉页脚
- [XLSX 区域提取器](https://elysiatools.com/zh/tools/xlsx-range-extractor): 提取指定工作表/区域/命名区域为 JSON，可保留坐标或转对象

## 示例

- [XLSX 样本](https://elysiatools.com/zh/samples/xlsx-samples): 用于工作表解析与数据提取测试的 XLSX 样本
- [Postman Collections - API 测试](https://elysiatools.com/zh/samples/postman-collections): 全面的 Postman collection 示例，包括 API 测试、自动化脚本、环境变量、mock 服务器和 REST API 的高级测试模式
- [XLS 样本](https://elysiatools.com/zh/samples/xls-samples): 用于二进制表格解析与导入测试的旧版 Excel (XLS) 表格样本
- [OpenAPI/Swagger 示例](https://elysiatools.com/zh/samples/openapi-swagger): 使用 OpenAPI 3.0 和 Swagger 规范的 RESTful 服务综合 API 文档示例

## 相关内容

- [XLSX 多来源 ETL 导入与数仓交付](https://elysiatools.com/zh/hubs/xlsx-etl-ingestion-workflows): 把多个工作簿和 CSV 来源整理成可追溯、带 schema 依据的 SQL、Parquet 与对象存储批处理输入。
- [KPI 报告包工作流](https://elysiatools.com/zh/hubs/kpi-report-pack-workflows): 把 API 与表格数据整理成 KPI 仪表盘、多标签 Excel 报告包、品牌化工作表、图表、迷你趋势图，以及高管可读的 PDF 或 Markdown 报告。