接入前需要确认
接入前请核对
发送嵌套JSON前,请选定并展平需要的记录字段。
接入前请核对
不要假定原表头名称会成为对象属性名。
代码示例
这些示例以 multipart/form-data 发送样例,并原样保存响应字节。请先设置环境变量 TABLECONVERT_API_KEY。
JSON 转 ActionScript数组 API · cURL
curl --fail-with-body --max-time 40 \
'https://api.tableconvert.com/v2/convert/json-to-actionscript' \
--header "Authorization: Bearer $TABLECONVERT_API_KEY" \
--form-string 'data=[
{
"sku": "P101",
"product": "Notebook",
"quantity": "12"
},
{
"sku": "P102",
"product": "Marker",
"quantity": "8"
}
]' \
--form-string 'output[minify]=false' \
--output 'json-to-actionscript.as'需要 cURL。若示例采用文件上传,请先下载输入样例。
JSON 转 ActionScript数组 API · Python
import os
from pathlib import Path
import requests
endpoint = "https://api.tableconvert.com/v2/convert/json-to-actionscript"
headers = {"Authorization": "Bearer " + os.environ["TABLECONVERT_API_KEY"]}
fields = {
"data": (None, "[\n {\n \"sku\": \"P101\",\n \"product\": \"Notebook\",\n \"quantity\": \"12\"\n },\n {\n \"sku\": \"P102\",\n \"product\": \"Marker\",\n \"quantity\": \"8\"\n }\n]"),
"output[minify]": (None, "false"),
}
response = requests.post(endpoint, headers=headers, files=fields, timeout=40)
response.raise_for_status()
Path("json-to-actionscript.as").write_bytes(response.content)需要 Python 3 与 requests,可通过 pip install requests 安装。
JSON 转 ActionScript数组 API · Node.js
import { writeFile } from "node:fs/promises";
const form = new FormData();
form.set("data", "[\n {\n \"sku\": \"P101\",\n \"product\": \"Notebook\",\n \"quantity\": \"12\"\n },\n {\n \"sku\": \"P102\",\n \"product\": \"Marker\",\n \"quantity\": \"8\"\n }\n]");
form.set("output[minify]", "false");
const response = await fetch("https://api.tableconvert.com/v2/convert/json-to-actionscript", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.TABLECONVERT_API_KEY },
body: form,
signal: AbortSignal.timeout(40_000),
});
if (!response.ok) {
throw new Error("HTTP " + response.status + ": " + await response.text());
}
await writeFile("json-to-actionscript.as", Buffer.from(await response.arrayBuffer()));需要 Node.js 20 或更新版本,使用内置 fetch、FormData 和 Blob。
身份验证
发送 Authorization: Bearer YOUR_API_KEY。请让 HTTP 客户端设置 multipart 边界,不要手动指定 Content-Type。
生产环境的 API Key 请保存在服务端环境变量中。
请求参数
非空的平铺对象数组最适合表示记录输入。对象键的并集形成列;嵌套结构不会自动展平。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
data | string | — | 直接发送 JSON 表格内容;data、file、url 三种来源任选其一。 |
file | binary | — | 通过 multipart/form-data 上传 json 文件。 |
url | string | — | 可公开访问的受支持文件 HTTP 或 HTTPS URL。 |
使用 data、file 或 url 提供一种输入来源。页面示例使用适合该格式的来源模式。
输出选项
生成适用于ActionScript集成样本的数组对象文本;生成器使用val0、val1等位置键,不把表头直接作为应用模型。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
output[minify] | boolean | false | 减少生成内容的排版空白;请检查该格式对单元格内容的具体影响。 |
转换规则
| 情况 | 处理方式 |
|---|---|
| 映射规则 1 | 对象键的并集形成表头,每个平铺对象提供一行文本单元格。 |
| 映射规则 2 | 各行变为带val0、val1位置键的对象,表头也作为第一个对象。 |
| 映射规则 3 | 请准备平铺记录数组;否则嵌套对象会在生成语言样本中变为[object Object]。 |
输入读取方式
- 对于对象数组,列按键首次出现的顺序排列;缺少的键对应空单元格。
- null变为字面文本null,数字与布尔值在表格规范化时变为文本。
- 嵌套对象变为[object Object];字段内数组变为逗号连接的文本,不会展开成额外行。
- 请在转换前准备明确的平铺字段;此接口没有通用flatten参数。
输出生成方式
- 输出数组包含每一行表格数据,也包含表头。
- 单元格以位置键下的字符串保留;请显式映射到业务字段。
- 请在目标运行时中检查生成文本;转换不会执行ActionScript。
适用场景
此转换的实际用途
以应用JSON响应为起始数据,准备ActionScript集成测试样本。发送嵌套JSON前,请选定并展平需要的记录字段。
ActionScript数组
为既有ActionScript客户端准备紧凑的表格测试样本。
响应与错误
| HTTP 状态 | 说明 |
|---|---|
200 | text/plain; charset=utf-8 |
400 | 输入或转换参数无效。 |
402 | 积分不足,无法处理此请求。 |
403 | API Key 缺失或无效。 |
413 | 输入超过已配置的请求限制。 |
415 | 不支持的输入媒体类型。 |
429 | 请求超过频率限制。 |
500 | 转换未能完成。 |
503 | 渲染服务不可用或请求超时。 |
重试前请先检查响应。新的 HTTP 请求属于新的转换,可能再次消耗积分。
限制、计费与版本
本地预览最多接受 200 KB。当前 API 实现允许上传一个不超过 50 MiB 的文件,multipart 中每个文本字段限制为 1 MiB,v2 转换任务的截止时间为 30 秒。部署环境可能设置更严格的限制。重试前请先检查错误内容;部分解析或渲染失败会返回 HTTP 500。
真实调用遵循 API 积分规则。转换失败会返还积分;若转换已完成,随后下载连接中断不会撤销该次成功转换。
查看 API 定价与积分参考资料与格式规范
格式参考资料用于说明底层语法;上方转换规则与样例描述 TableConvert 的实际实现。