用途
本技能是一份 LINE Messaging API 的综合参考,用于构建、审查和调试 LINE 机器人及 LINE Messaging API 集成。文档明确指出:不要凭记忆回答 LINE API 相关问题,因为 LINE 会频繁更新 API,训练数据不可靠,应始终查阅所提供的 references 参考文件。
主要能力
- 通用规范:在编写任何 LINE 机器人代码前应先阅读 references/api-common.md,其中包含影响所有 API 交互的规则,如向前兼容(不要使用严格 schema,LINE 会在不通知的情况下新增字段)、速率限制、错误处理、重试策略与日志建议。
- Webhook:验证使用 x-line-signature 请求头(HMAC-SHA256、base64、密钥为 Channel Secret);请求体格式为 {"destination": "U...", "events": [...]};机器人服务器必须返回 200。文档提供了签名验证的伪代码,并强调在验证前不得反序列化或重新格式化请求体,且仅使用 UTF-8 编码,应尽量使用官方 SDK(其会自动处理)。
- 消息发送:所有发送均需 Authorization: Bearer {channel access token}。支持的发送模式包括 Reply(POST /v2/bot/message/reply,需要一次性 replyToken)、Push(POST /v2/bot/message/push)、Multicast(最多 500 个用户)、Broadcast(发送给所有好友)。每次请求最多 5 条消息。域名为 api.line.me(一般)和 api-data.line.me(内容上传)。
- Flex Message:采用三层结构:Container(Bubble / Carousel)→ Block(Header / Hero / Body / Footer)→ Component(Box / Button / Image / Video / Icon / Text / Span / Separator)。文档给出了最小 Flex Message 示例。
- Rich Menu:CRUD、标签切换、显示优先级。
- Audience:受众管理(创建/添加/获取/删除)。
- Insights:送达、关注者与互动洞察。
- 其他:用户资料与好友 ID、账户链接;群组/聊天室消息与成员 API;Channel access token 生命周期;优惠券 CRUD、奖励类型与发送;LINE URL schemes 深度链接。
- 专家引导:references/experts.md 提供架构或设计选择的方向性指导,包含专家领域路由与 17 个专家档案。
使用方式
构建流程:
- 阅读 references/api-common.md(速率限制、向前兼容、错误处理);
- 加载正在实现功能的相关参考;
- 对于架构或设计选择,查阅 references/experts.md 获取方向性指导;
- 按照参考中的规范与约束编写代码。
审查/调试流程:
- 阅读 references/api-common.md(速率限制、错误代码);
- 加载所审查代码的相关参考;
- 对照规范交叉检查代码(大小限制、token 过期、计数规则、必填字段);
- 对于设计模式问题,查阅 references/experts.md;
- 报告违规并引用具体约束。
环境变量:
- LINE_CHANNEL_ACCESS_TOKEN=Bot access token(机器人访问令牌)
- LINE_CHANNEL_SECRET=Channel secret(用于 webhook 签名验证)
SDK:官方 SDK 提供 Python、Node.js、Go、Java、PHP、Ruby 版本;其他语言可使用 LINE OpenAPI specs 配合 OpenAPI Generator。
参考索引
- references/api-common.md:先阅读。速率限制、错误处理、向前兼容
- references/webhook-events.md:Webhook 事件类型与 JSON 结构
- references/message-objects.md:消息对象、Quick Reply、发送者自定义
- references/action-objects.md:动作对象(postback、URI、datetimepicker 等)
- references/message-sending.md:Reply/Push/Multicast/Narrowcast/Broadcast、统计
- references/flex-message.md:Flex Message 组件、布局、样式
- references/rich-menu.md:Rich Menu CRUD、标签切换、显示优先级
- references/user.md:用户资料、好友 ID、账户链接
- references/group-chat.md:群组/聊天室消息与成员 API
- references/audience.md:受众管理(创建/添加/获取/删除)
- references/insights.md:送达、关注者与互动洞察
- references/channel-token.md:Channel access token 生命周期
- references/coupon.md:优惠券 CRUD、奖励类型、发送
- references/url-schemes.md:LINE URL schemes 深度链接
- references/experts.md:专家领域路由与 17 个专家档案
- assets/examples/:Flex Message JSON 示例(11 个展示案例)
适用场景
适用于 LINE 机器人的开发、代码审查与问题调试,以及涉及 LINE Messaging API 各类功能(消息发送、Flex Message、Rich Menu、受众、洞察、群组、优惠券等)的实现与集成工作。
限制
资料未提供该技能的收费、价格或具体安装命令等信息;相关内容暂未提供。