Things to check before integrating
Before you integrate
Place the intended sheet first, or upload it as a separate workbook; inspect dates and leading-zero identifiers in the extracted values.
Before you integrate
Do not assume the original header names become object property names.
Code examples
These examples send the sample as multipart/form-data and save the returned bytes unchanged. Set TABLECONVERT_API_KEY in your environment.
Excel to ActionScript array API · cURL
curl --fail-with-body --max-time 40 \
'https://api.tableconvert.com/v2/convert/excel-to-actionscript' \
--header "Authorization: Bearer $TABLECONVERT_API_KEY" \
--form 'file=@excel-to-actionscript-input.xlsx' \
--form-string 'output[minify]=false' \
--output 'excel-to-actionscript.as'Requires cURL. Download the sample input first when this example uploads a file.
Excel to ActionScript array API · Python
import os
from pathlib import Path
import requests
endpoint = "https://api.tableconvert.com/v2/convert/excel-to-actionscript"
headers = {"Authorization": "Bearer " + os.environ["TABLECONVERT_API_KEY"]}
fields = {
"output[minify]": (None, "false"),
}
with open("excel-to-actionscript-input.xlsx", "rb") as source:
files = {**fields, "file": ("excel-to-actionscript-input.xlsx", source)}
response = requests.post(endpoint, headers=headers, files=files, timeout=40)
response.raise_for_status()
Path("excel-to-actionscript.as").write_bytes(response.content)Requires Python 3 and requests. Install it with pip install requests.
Excel to ActionScript array API · Node.js
import { readFile, writeFile } from "node:fs/promises";
const form = new FormData();
form.set("file", new Blob([await readFile("excel-to-actionscript-input.xlsx")]), "excel-to-actionscript-input.xlsx");
form.set("output[minify]", "false");
const response = await fetch("https://api.tableconvert.com/v2/convert/excel-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("excel-to-actionscript.as", Buffer.from(await response.arrayBuffer()));Requires Node.js 20 or later with built-in fetch, FormData and Blob.
Authentication
Send Authorization: Bearer YOUR_API_KEY. Let the HTTP client set the multipart boundary; do not set Content-Type manually.
Keep production API keys in server-side environment variables.
Request parameters
The API reads the first worksheet of an uploaded workbook as cell values and normalizes it into table rows. It does not preserve the workbook’s formulas, charts or visual design.
| Parameter | Type | Default | Description |
|---|---|---|---|
data | string | — | For workbook input, use file or url. The example uploads a real .xlsx workbook. |
file | binary | — | Upload a xlsx file using multipart/form-data. |
url | string | — | A supported publicly accessible HTTP or HTTPS file URL. |
Send one source: data, file, or url. The examples below use the source mode appropriate for this format.
Output options
Generate array-style object text for an ActionScript integration fixture. The generator uses positional val0, val1 keys rather than adopting the table header as an application model.
| Parameter | Type | Default | Description |
|---|---|---|---|
output[minify] | boolean | false | Reduce generated layout whitespace; inspect any format-specific effects on cell content. |
Conversion rules
| Case | Behavior |
|---|---|
| Mapping rule 1 | The first worksheet’s values become rows and columns, with the first extracted row available as the destination header. |
| Mapping rule 2 | Rows become objects with positional val0, val1 keys, including the table header as the first object. |
| Mapping rule 3 | Generate a fixture from visible worksheet values, then review code literals; formulas and workbook objects are not executable code inputs here. |
How the input is read
- Place the intended data in the first worksheet, using a simple rectangular range with a deliberate first-row header.
- The conversion uses extracted cell values, not the spreadsheet as an executable calculation model.
- Only the first extracted worksheet is converted. There is no input sheet-selection parameter, and workbook sheets are not merged.
- Review date displays, leading zeros and large identifiers after extraction; original Excel types and formatting do not transfer to every target.
How the output is written
- Every table row, including the header, is represented in the array output.
- Cells remain strings under positional keys; map them to domain fields explicitly.
- Review generated text in the target runtime; conversion does not execute ActionScript.
When to use this API
This conversion in practice
Use a worksheet export as the starting dataset for an ActionScript integration fixture. Place the intended sheet first, or upload it as a separate workbook; inspect dates and leading-zero identifiers in the extracted values.
ActionScript array
Create compact tabular fixtures for an existing ActionScript client.
Responses and errors
| HTTP status | Description |
|---|---|
200 | text/plain; charset=utf-8 |
400 | Invalid input or conversion parameters. |
402 | Insufficient credits for this request. |
403 | Missing or invalid API key. |
413 | The input exceeds the configured request limit. |
415 | Unsupported input media type. |
429 | Rate limit exceeded. |
500 | The conversion could not be completed. |
503 | The renderer is unavailable or the request timed out. |
Check the response before retrying. A new HTTP request is a new conversion and may use credits again.
Limits, billing and versions
Local previews accept up to 200 KB. The current API implementation allows one uploaded file up to 50 MiB, limits each multipart text field to 1 MiB, and gives v2 conversion tasks a 30-second deadline. Deployment limits may be stricter. Read the returned error before retrying; some parser or renderer failures return HTTP 500.
Live calls follow the API credit policy. Failed conversions are refunded; a completed conversion is not undone if the download connection later fails.
View API pricing and creditsUsing API v1?
This page documents v2, which returns the output directly. API v1 wraps the result in a JSON envelope. Check the overview before changing an existing integration.
API overviewReferences and format specifications
Format references explain the underlying syntax. The conversion rules and samples above describe TableConvert’s implementation.