查询景区列表

接口说明

查询平台的景区列表，返回景区编码和名称。

接口编码：operator.scenic.info.query

请求的加密、签名和响应解密规则见「接入说明与返回码」。

请求业务字段

以下为加密前的业务参数，序列化为 JSON 字符串并加密后填入外层 body。

字段	类型	必填	说明
`scenicName`	string	否	景区名称关键字，模糊匹配景区名称或别名；不传返回全部景区

没有筛选条件时，对空对象 {} 加密后填入外层 body。

请求业务示例

{
  "scenicName": "宋城"
}

响应业务字段

响应体解密后为统一结构 {code, msg, data, ok}。data 为景区数组；没有匹配的景区时为空数组 []。数组元素：

字段	类型	说明
`scenicCode`	string	景区编码
`scenicName`	string	景区名称
`aliasName`	string	景区别名

响应示例（解密后）

{
  "code": 0,
  "msg": null,
  "data": [
    {
      "scenicCode": "PK20251229193723",
      "scenicName": "杭州宋城景区",
      "aliasName": "杭州宋城景区别名"
    }
  ],
  "ok": true
}

业务错误

业务校验不通过时 code 非 0，msg 为具体原因。返回码含义见「接入说明与返回码」第 9.2 节，下游业态服务给出的返回码原样透出：

code	msg	说明
`1031`	该接口仅支持运营平台操作员调用	应用实例绑定的不是运营平台操作员
`1020`	业务参数格式有误，必须为JSON对象	业务参数不是 JSON 对象，或字段类型不对

{
  "code": 1031,
  "msg": "该接口仅支持运营平台操作员调用",
  "data": null,
  "ok": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

响应体为 Base64 密文，用 aesKey 解密后得到统一响应 OpenResponse，data 的结构如下；被网关拒绝时为明文 JSON，见「接入说明与返回码」

Bodyapplication/json

示例

{
    "code": 0,
    "msg": null,
    "data": [
        {
            "scenicCode": "PK20251229193723",
            "scenicName": "杭州宋城景区",
            "aliasName": "杭州宋城景区别名"
        }
    ],
    "ok": true
}

接口说明#

请求业务字段#

请求业务示例#

响应业务字段#

响应示例（解密后）#

业务错误#

请求参数