LINE API Playground 即将停用:把测试迁移到 curl
LINE 计划于 2026 年 11 月 30 日停用 Messaging API reference 中的 API Playground,并不是停用 Messaging API。官方建议改用 curl 等工具,按照各端点文档中的示例发送请求。你需要替换的是浏览器里的测试操作说明,而不是正常工作的 API 集成;先用只读请求检查配置,再单独测试消息发送。
重点结论
- 停用的是浏览器测试功能,不是 Messaging API。
- 请求模板与真实 channel access token 应分开保存。
- 成功查询机器人信息,不代表消息已送达或 Webhook 能正常接收。
- 更换测试工具,不要求更换发送身份,也不要求迁移到 UnifyPort。
LINE 到底要停用什么
LINE 2026 年新闻中的 11 月 13 日公告说明,API Playground 是 API reference 内的功能,可以在浏览器中向部分端点发送请求并查看响应。LINE 表示,停用决定考虑了使用情况及持续运营的安全要求,并明确指出 Messaging API 本身不受影响。
截至本文 11 月 19 日核验时,这仍是计划中的停用,不能写成已经发生的服务中断。公告针对这一特定工具,不能扩大解释为所有 LINE 开发工具都要停止使用。
请检查团队的接入文档、排障步骤和截图,找出“点击 Try”的指引。将它们替换为经过审核的请求示例、凭据来源和响应判读说明。仅因为这个按钮将消失,无须重写现有应用代码。
先用只读查询替代首次测试
Messaging API reference提供 GET /v2/bot/info,用于读取 LINE 官方账号的基本信息,并要求使用 channel access token 认证。它适合作为第一项检查,因为不会向客户发送消息。
运行前先完成以下准备:
- 选择目标测试 channel,记录它对应的 LINE 官方账号。
- 通过受保护的本地环境把 token 注入
LINE_CHANNEL_ACCESS_TOKEN。这是示例环境变量名,不是 LINE API 字段。 - 使用可信终端,关闭命令跟踪。不要把真实 token 粘贴到共享文档、截图或录屏中。
- 如果不清楚应使用哪项凭据,先看 channel access token 位置指南。不要只是为了换测试工具,就重新签发仍在使用的凭据。
以下是说明用的 shell 请求,本文没有执行它:
printf 'Authorization: Bearer %s\n' "$LINE_CHANNEL_ACCESS_TOKEN" |
curl --silent --show-error --include \
--header @- \
'https://api.line.me/v2/bot/info'
这里通过标准输入传递认证请求头,而不是把密钥直接写进命令文本。这不等于完整的密钥管理方案:环境变量和终端仍需保护。不要开启详细跟踪,也不要上传未经脱敏的诊断记录。
检查 HTTP 状态与响应正文,将返回的账号信息和预期发送方进行比对。如果请求成功,但返回的是另一个账号,配置检查仍然失败。没有收到 HTTP 响应,则尚不能确定 API 结果;它与收到明确 API 错误不同。
若请求和文档不一致,按照 LINE 端点 URL 检查清单核对最终的 method、host 和 path,不要同时修改凭据与请求体。
三类测试结果必须分开
| 测试 | 可以确认什么 | 不能确认什么 |
|---|---|---|
| 查询机器人信息 | 本次请求通过认证并返回账号身份 | 客户消息送达、Webhook 正常运行 |
| 向同意参与的测试用户主动发送 | 这一次发送操作的实际观察结果 | 其他所有收件人都能收到 |
| 通过 Webhook 接收一条新消息 | 这一事件的接收链路 | 所有发送操作都正常 |
需要测试发送时,依据官方文档明确选择发送方法和测试收件人。不要把保存的生产请求拿来当连通性探针。首次手动检查不要加入自动重试;响应丢失可能意味着结果不确定。支持重试键的发送设计请另看 LINE retry key 指南。
新的操作手册建议记录:操作类型、测试 channel 标签、观察时间、HTTP 状态和脱敏后的响应摘要。共享证据中不要包含 access token 或客户消息内容。这些是建议的本地记录,不是新增的 LINE 响应字段。
UnifyPort 的适用边界
UnifyPort 提供独立的非官方接口,并不是 LINE API Playground 的替代托管站点。文本发送文档定义的是 POST /v1/messages,使用 X-Api-Key 认证,请求字段包括 account_id、to 和 message。不能直接把 LINE channel access token 和原生 Messaging API 请求粘贴到这个接口里。
已经使用 UnifyPort 的团队,应为它的 API 和入站事件维护独立测试说明。如果必须以 LINE 官方账号身份发送并使用官方能力,继续使用 Messaging API 即可。测试界面的移除,不是迁移消息账号或更换生产 Webhook 的理由。
常见问题
LINE Messaging API 会在 11 月 30 日关闭吗?
不会。该公告计划移除的是 API Playground,并明确说明 Messaging API 本身不受影响。
改用 curl 需要申请新 token 吗?
仅更换 HTTP 客户端不构成轮换 token 的要求。使用目标 channel 的有效 token,并将它与保存的请求模板分开保护。
查询机器人信息成功,能证明机器人能接收消息吗?
不能。入站 Webhook 必须单独测试。同样,账号查询成功也不是客户已收到消息的证据。
下一步与参考资料
先把一处内部“点击 Try”的说明,替换为官方 Messaging API reference中的只读检查,再分别补充发送和接收测试。
官方资料核验日期:2026-11-19。
让消息接入变成一条稳定的产品管线。
先用统一 API 跑通发送,再用标准事件把所有入站消息接回业务系统。