扣子自定义API插件配置指南：实时天气查询

要让扣子的机器人调用你自己的天气接口并准确返回温度、湿度和天气状况，唯一路径是配置自定义API插件。别指望平台内置的天气模块——它无法对接你的私有数据源。你必须手动实现POST请求、application/json格式，接口返回的JSON必须包含code和data，且data内至少要有temperature、weather、humidity三个字段。下面拆解完整操作流程，每一步遗漏都会导致调用失败。

搭建扣子兼容的天气API服务

扣子对API的约束非常清晰：仅支持POST请求，Content-Type固定为application/json。如果你的天气接口仍用GET或返回XML，必须改造后端——别抱侥幸心理，插件测试阶段就会直接抛出错误，无法通过。

接口返回的结构需严格按示例：code字段标识状态（200代表成功），data对象内至少包含temperature、weather、humidity三个键。缺失任意一个，后续Bot逻辑取值时都会报undefined错误，排查半天也找不到根因。

本地调试时，用Python快速起一个mock服务：flask run --port=5001。然后执行这条curl命令验证：curl -X POST http://localhost:5001/weather -H "Content-Type: application/json" -d '{"city":"北京"}'，确认能返回合法JSON。这步看着多余，实际能省掉集成时的大量返工。

在扣子开发者后台创建API插件

登录扣子官网，进入「开发者中心」，点击「API插件」，再点右上角的「新建插件」。

基础信息如实填写：插件名称设为“实时天气查询”，描述写“根据城市名返回当前温度、天气状况和湿度”，调用方式选「HTTP请求」。这些都是标准操作。

核心配置在请求部分。URL填写你的API地址，例如https://yourdomain.com/weather，请求方法选POST，请求头添加Content-Type: application/json。

接着在请求体里选「JSON」，点击「添加参数」，参数名设为city，类型选「字符串」，并务必勾选「必填」。这一步遗漏会导致所有调用返回默认城市数据，或者直接抛错——踩过坑的人才知道后果。

定义插件输出Schema并发布

响应解析有两种方案。第一种是手动定义结构，适合接口稳定的场景。在「响应解析」区域点击「添加字段」，依次添加temperature（数字类型）、weather（字符串类型）、humidity（数字类型）。每个字段的JSON路径分别填$.data.temperature、$.data.weather、$.data.humidity。路径写错一个，对应字段就为空，Bot拿不到数据。

第二种是自动推导，仅适合调试阶段。先点击「测试请求」，输入city="上海"，成功返回后点击「从响应自动推导」。系统会依据实际返回的JSON自动生成字段，但有个坑：若data里多出了wind_speed之类未声明的字段，系统不会自动添加，后续Bot脚本无法直接访问。所以最终仍需手动确认所有字段完整。

全部配置完后，点击右上角的「发布」。发布成功后插件状态变为「已启用」，此时才能在Bot工作流中调用它。整个过程听起来简单，但每个细节踩过坑的人都知道：漏一个参数、写错一个路径，排查起来有多耗时。

来源：互联网