每日空闲时长 - 联网开放平台

请求参数

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/idle_time' \
--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,
        "pierceCount": 1519
      },
      {
        "statDate": 20230202,
        "pierceCount": 2435
      },
      {
        "statDate": 20230203,
        "pierceCount": 2412
      },
      {
        "statDate": 20230204,
        "pierceCount": 3569
      },
      {
        "statDate": 20230205,
        "pierceCount": 4580
      },
      {
        "statDate": 20230206,
        "pierceCount": 5246
      },
      {
        "statDate": 20230207,
        "pierceCount": 5013
      }
    ]
  }
}