目录
要创建 WPS AirScript 脚本令牌（APIToken），请先打开 WPS 多维表格的 AirScript 脚本编辑器，在工具栏选择“脚本令牌”，阅读提示后勾选“我已知晓”并创建。若账号尚未完成实名认证，需先按页面提示完成认证；令牌生成后应立即复制并妥善保存，避免发送到群聊、文档或公开代码库。
先看结论：令牌是给外部系统调用脚本用的
AirScript 脚本令牌也称 APIToken，是外部业务系统调用已写好 AirScript 脚本时使用的身份凭证。它不是普通脚本运行必需的设置：如果只在 WPS 多维表格内编辑、手动运行脚本或配置平台内自动化，通常不需要创建令牌；如果要让自建服务、内部工具或其他程序通过 HTTP 请求执行脚本，则需要令牌配合脚本的 Webhook 链接。
| 你的情况 | 建议 |
|---|---|
| 只在多维表格中手动运行脚本 | 一般不必创建脚本令牌 |
| 需要从自建系统或服务端触发脚本 | 创建令牌，并使用 Webhook 调用 |
| 要处理脚本版本兼容问题 | 先确认脚本是 AirScript 1.0 还是 2.0 |
创建前要准备什么
- 可访问的 WPS 多维表格及其中的 AirScript 脚本编辑器。
- 用于创建令牌的 WPS 账号。官方说明指出，未完成实名认证的账号需要先完成认证。
- 明确的调用场景，例如由内部系统触发脚本读取或写入对应文件的数据。
- 安全的保存位置，例如企业密钥管理服务、受权限控制的环境变量或加密凭据库。
创建 WPS AirScript 脚本令牌的步骤
1. 进入 WPS 多维表格并打开脚本编辑器
打开目标多维表格后，进入脚本功能并调起 AirScript 编辑器。官方开发文档列出的新建入口为“脚本”→“JS脚本”→“新建脚本”；如果你已经有脚本，可直接进入对应的脚本编辑器。
2. 在工具栏选择“脚本令牌”
在 AirScript 编辑器工具栏中找到并点击“脚本令牌”。如果你的界面未显示该入口，不要根据其他平台的路径猜测；可先确认当前打开的是 WPS 多维表格的 AirScript 编辑器，以及账号和地区是否具备相应能力。
3. 阅读提示并确认创建
首次创建时，页面会展示令牌相关说明。确认自己理解令牌可用于外部调用脚本后，勾选“我已知晓”，再选择“创建脚本令牌”。
4. 按提示完成实名认证
如系统提示需要实名认证，应先完成该流程，再返回令牌创建页面继续操作。认证要求的目的在于提升外部调用凭证的安全性。
5. 复制令牌并立即安全保存
创建成功后，复制显示的 APIToken，并保存到受控位置。不要把完整令牌写进前端网页、公开示例、截图、共享表格或可被无关人员访问的聊天记录中。若令牌疑似泄露，建议尽快删除旧令牌并重新创建，随后替换调用端保存的凭据。
创建后如何确认令牌能用于调用
令牌创建完成并不等于已经能执行目标脚本。还需要在脚本编辑器侧边栏中找到目标文档共享脚本，从其更多菜单复制 Webhook 链接。该链接包含文件 ID 与脚本 ID；调用时，请求头需要传入AirScript-Token，值为你创建的脚本令牌。
调用接口可选择同步或异步方式：同步调用适合需要直接获得执行结果的任务；异步调用会先返回任务标识，调用方再查询任务状态与日志。无论采用哪种方式，都应先用权限最小、影响范围可控的脚本验证调用逻辑，避免一开始就对大量业务数据执行写入操作。
示例场景：从内部工具触发一次表格更新
示例（假设场景）：某教务团队在内部系统中汇总报名信息，希望在每天导入数据后自动调用一段 AirScript 脚本，对多维表格中的记录进行整理。管理员可以先在目标多维表格中编写并确认脚本逻辑，再创建 APIToken、复制该文档共享脚本的 Webhook，并由服务端在请求头中保存令牌。令牌不应下发到教师或学生使用的浏览器页面。
令牌创建与调用时的安全要点
- 令牌与账号绑定：官方说明显示，一个用户最多保有一个脚本令牌；如需新建，通常需要先删除旧令牌。
- 注意有效期：官方文档说明令牌默认有 180 天有效期，并支持在创建时延长；实际页面展示与可选设置请以当前界面为准。
- 令牌和 Webhook 都要保护：两者配合可对相应文件执行脚本，因此应按敏感凭据管理。
- 服务端保存优先：尽量将令牌放在服务端环境变量或凭据管理服务中，不要嵌入前端 JavaScript。
- 区分脚本版本：如果调用或 API 行为异常，检查脚本运行时版本与所参考的 API 文档是否一致。关于差异可继续阅读WPS AirScript 2.0和1.0有什么区别。
常见问题
找不到“脚本令牌”按钮怎么办？
先确认当前位置是 WPS 多维表格的 AirScript 脚本编辑器，而不是普通文档、表格或其他自动化页面。若确认无误仍未显示，请以当前账号、地区与客户端或网页端实际界面为准，并查阅官方开发文档中的入口说明。
创建令牌后，能直接执行“我的脚本”吗？
官方说明提到，当前开放复制 Webhook 链接的是文档共享脚本。因此，在规划外部调用前，应先确认目标脚本的类型以及侧边栏更多菜单中是否提供复制 Webhook 的选项。
脚本令牌能否多人共用？
不建议把个人令牌作为团队共享密码传播。令牌与用户绑定，且可配合 Webhook 访问相应脚本与文件资源。团队使用时，应建立凭据保管、人员变更和泄露后的轮换流程。
同步调用和异步调用怎么选？
需要在一次请求中直接拿到结果、且预计执行时间较短时，可考虑同步调用；任务耗时较长或不希望请求一直等待时，可考虑异步调用，并根据返回的任务标识查询执行状态和日志。
验证情况与使用说明
本文依据相关品牌的官方帮助资料整理。具体功能入口、规则名称和可选样式可能随系统、地区、账号与版本变化，请以当前客户端或官方页面显示为准。本页为第三方使用教程，并非相关品牌的官方帮助页面。