SuperAPI AI 工具集

messaging-api

编程与开发

查看项目

更新于 10-15 09:48

技能介绍

用途

本技能是一份 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 个专家档案。

使用方式

构建流程:

  1. 阅读 references/api-common.md(速率限制、向前兼容、错误处理);
  2. 加载正在实现功能的相关参考;
  3. 对于架构或设计选择,查阅 references/experts.md 获取方向性指导;
  4. 按照参考中的规范与约束编写代码。

审查/调试流程:

  1. 阅读 references/api-common.md(速率限制、错误代码);
  2. 加载所审查代码的相关参考;
  3. 对照规范交叉检查代码(大小限制、token 过期、计数规则、必填字段);
  4. 对于设计模式问题,查阅 references/experts.md;
  5. 报告违规并引用具体约束。

环境变量:

  • 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、受众、洞察、群组、优惠券等)的实现与集成工作。

限制

资料未提供该技能的收费、价格或具体安装命令等信息;相关内容暂未提供。