微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # API变更日志回调

    # 接口说明

    微信小店会通过该接口将API变更日志相关消息通知给商户，以便商户及时掌握接口变动情况，做好业务调整与适配。

    # 注意事项

    • 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，商户将无法收微信小店发送的通知；
    • 商户需密切关注API变更内容，及时评估对自身业务的影响，避免因接口变动导致业务异常。

    # 请求参数说明

    参数 类型 描述
    ToUserName string 接收通知的小店UserName
    FromUserName string 微信平台标识的OpenID，固定值
    CreateTime number 事件时间，Unix时间戳，即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至当前的总秒数
    MsgType string 消息类型，固定为event
    Event string 事件类型，本接口固定为api_diff
    changelog_url string API变更日志文档链接，可点击查看详细变更信息
    api_changes array API具体变更内容数组，每个元素为一个API变更详情对象，具体结构参考APIDiffObject结构体
    change_time number API变更发生时间，Unix时间戳，即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至当前的总秒数

    # 请求参数示例（解密后的明文JSON）

    {
    "ToUserName": "gh_6a4cebfd5b9c", 
    "FromUserName": "oM0yI7WiASw6i5e3ZXKVKFYa9A9c", 
    "CreateTime": 1762492842, 
    "MsgType": "event", 
    "Event": "api_diff", 
    "changelog_url": "https://developers.weixin.qq.com/doc/store/shop/changelog.html",
    "api_changes": [
        {
            "chinese_name": "电子面单取号",
            "cgi_path": "/channels/ec/logistics/ewaybill/biz/order/create",
            "doc_url": "https://developers.weixin.qq.com/doc/store/shop/API/channels-shop-delivery/ewaybill/api_ewaybill_createorder",
            "change_content": "更新接口：调整「跨店打单」模式（入参`ewaybill_order_code` `ewaybill_order_appid`字段）的使用条件。"
        }
    ],
    "change_time": "1762492842"
}

    # 返回参数说明

    只需直接返回字符串：success

    # 返回参数示例

    success

    # 结构体

    # APIDiffObject

    参数名 类型 描述
    chinese_name string API的中文名称，便于商户直观识别接口用途
    cgi_path string API的接口路径（CGI路径），唯一标识该接口
    doc_url string API官方文档的链接，商户可通过该链接查看接口的完整说明
    change_content string API的具体变更内容描述