电商3.0-运营平台开放接口
    • 概览
    • 快速开始
    • 请求与加密
    • 响应处理
    • 示例与自测
    • 数据约定
    • 返回码与排查
    • 更新日志
    • 订单
      • 查询订单列表
        POST
      • 查询订单详情
        POST
      • 取消预约
        POST
    • 售后
      • 申请退单
        POST
      • 查询退单
        POST
    • 景区
      • 查询景区列表
        POST
      • 查询景区详情
        POST

    快速开始

    按下面四步完成第一次调用。全程只读,不会改动任何数据。

    第一步:拿到开发环境凭证#

    向平台管理员申请开发环境的 key、secret、aesKey,并确认应用实例已授权「查询景区列表」。应用实例开启了 IP 白名单时,把调用方的出口 IP 告知管理员。

    第二步:离线自测加密和签名#

    不需要网络,用示例与自测的演示数据:
    1.
    用该页的 OpenSSL 命令算出 body,与 43EYRVvX8lxqL6rR/XZ+iBSNgsos0HHX8JUVQJsDDhk= 比对。
    2.
    运行你所用语言的示例代码,或把演示数据代入你自己的实现,输出必须与该页列出的值逐字节一致,包括含中文的 88 个字符响应体。
    两条自测判据都通过后再联调。只通过第一条不能说明实现正确。

    第三步:第一次调用#

    用你自己的代码和开发环境凭证调用「查询景区列表」:
    地址:https://scthub-open.dev.dmqwl.com/operator/open/scenic/infoQuery
    业务参数:{"scenicName":"宋城"}(传 {} 返回全部景区)
    按请求与加密把业务参数加密为 body、签名,发送 {"key":…,"timestamp":…,"body":…,"sign":…}。
    响应体不以 { 开头时用 aesKey 解密,期望得到 "code":0 和景区列表。
    响应体以 { 开头是明文响应,通常是请求被网关拒绝,按 code 查返回码与排查;1037 数据验证失败 按该页的「签名失败排查」逐项检查。

    第四步:继续接入#

    用「查询订单列表」按联系电话查订单,再读数据约定的订单模型和典型流程。
    接入「申请退单」「取消预约」前,读响应处理的「超时与重试」。
    修改于 2026-11-11 19:17:40
    上一页
    概览
    下一页
    请求与加密
    Built with