每日开气时长 - 联网开放平台

请求参数

Header 参数

zoneId

string

可选

可选，可以通过指定时区ID，指定查询的时区。不指定时默认查询时区为 Asia/Shanghai；
时区 ID 需要来自 IANA 时区数据库（TZDB）。无法识别的时区将被转化为 Asia/Shanghai；

示例值:

America/Chicago

Body 参数application/json

cardId

string

控制卡ID

必需

startDate

integer

查询开始日期

必需

必须为三个月内，过早的时间段的统计数据不提供查询服务

endDate

integer

查询截止日期

必需

必须为三个月内，过早的时间段的统计数据不提供查询服务

示例

{
    "cardId": "123456789100",
    "startDate": 20230201,
    "endDate": 20230207
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://mcs-gateway.fscut.com/api/statistics/daily/gas_on' \
--header 'zoneId: America/Chicago' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardId": "123456789100",
    "startDate": 20230201,
    "endDate": 20230207
}'

返回响应

🟢200成功

application/json

Body

status

integer

状态码

必需

成功响应为0，非0为异常码

msg

string

响应信息

必需

成功响应为ok，非成功响应则为异常信息

data

object

必需

list

array [object {2}]

必需

示例

{
    "status": 0,
    "msg": "OK",
    "data": {
        "list": [
            {
                "statDate": 20230201,
                "gasOn": 13417
            },
            {
                "statDate": 20230202,
                "gasOn": 9429
            },
            {
                "statDate": 20230203,
                "gasOn": 13154
            },
            {
                "statDate": 20230204,
                "gasOn": 13694
            },
            {
                "statDate": 20230205,
                "gasOn": 21155
            },
            {
                "statDate": 20230206,
                "gasOn": 24400
            },
            {
                "statDate": 20230207,
                "gasOn": 20306
            }
        ]
    }
}