1. 景区
电商3.0-运营平台开放接口
  • 接入说明与返回码
  • 订单
    • 查询订单
      POST
    • 取消预约
      POST
  • 售后
    • 申请退单
      POST
    • 查询退单
      POST
  • 景区
    • 查询景区列表
      POST
    • 查询景区营业时间
      POST
  • 数据模型
    • OpenRequest
    • OpenResponse
  1. 景区

查询景区营业时间

POST
/operator/open/scenic/businessHoursGet
最后修改时间:2026-11-11 15:39:59
责任人:未设置

接口说明#

按景区编码查询营业时间。
营业时间目前由平台维护的对照表提供,尚未配置的景区会返回「该景区暂未配置营业时间」。
接口编码:operator.scenic.businessHours.get
请求的加密、签名和响应解密规则见「接入说明与返回码」。

请求业务字段#

以下为加密前的业务参数,序列化为 JSON 字符串并加密后填入外层 body。
字段类型必填说明
scenicCodestring是景区编码,取自「查询景区列表」

请求业务示例#

{
  "scenicCode": "PK20251229193723"
}

响应业务字段#

响应体解密后为统一结构 {code, msg, data, ok}。data 为营业时间对象:
字段类型说明
scenicCodestring景区编码
scenicNamestring景区名称
openTimestring开园时间,格式 HH:mm
closeTimestring闭园时间,格式 HH:mm
remarkstring补充说明

响应示例(解密后)#

{
  "code": 0,
  "msg": null,
  "data": {
    "scenicCode": "PK20251229193723",
    "scenicName": "杭州宋城景区",
    "openTime": "09:00",
    "closeTime": "21:00",
    "remark": null
  },
  "ok": true
}

业务错误#

业务校验不通过时 code 非 0,msg 为具体原因。返回码含义见「接入说明与返回码」第 9.2 节,下游业态服务给出的返回码原样透出:
codemsg说明
1021景区编码不能为空未传 scenicCode
405景区不存在景区编码不存在
405该景区暂未配置营业时间景区存在,但平台尚未配置其营业时间
1031该接口仅支持运营平台操作员调用应用实例绑定的不是运营平台操作员
1020业务参数格式有误,必须为JSON对象业务参数不是 JSON 对象,或字段类型不对
{
  "code": 1021,
  "msg": "景区编码不能为空",
  "data": null,
  "ok": false
}

请求参数

Body 参数application/json必填

示例
{
    "key": "调用方的key",
    "timestamp": 1794370000000,
    "body": "业务参数加密后的Base64密文",
    "sign": "MD5(body+timestamp+secret)"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://scthub-open.dev.dmqwl.com/operator/open/scenic/businessHoursGet' \
--header 'Content-Type: application/json' \
--data '{
    "key": "调用方的key",
    "timestamp": 1794370000000,
    "body": "业务参数加密后的Base64密文",
    "sign": "MD5(body+timestamp+secret)"
}'

返回响应

🟢200成功
application/json
响应体为 Base64 密文,用 aesKey 解密后得到统一响应 OpenResponse,data 的结构如下;被网关拒绝时为明文 JSON,见「接入说明与返回码」
Bodyapplication/json

示例
{
    "code": 0,
    "msg": null,
    "data": {
        "scenicCode": "PK20251229193723",
        "scenicName": "杭州宋城景区",
        "openTime": "09:00",
        "closeTime": "21:00",
        "remark": null
    },
    "ok": true
}
修改于 2026-11-11 15:39:59
上一页
查询景区列表
下一页
OpenRequest
Built with