批量查询指定月份的流量使用情况/ Batch querying the usage in a specified month

Cube UAT

POST

/flow/totalMonthFlowList

批量查询其拥有的所有设备信息在指定月份流量使用情况。
//Batch querying the usage of all devices/SIM cards in a specified month.

请求参数

Header 参数

Accept-Language

string

可选

默认，当header中无语言要求时，默认返回简体中文。当前支持zh-CN（简体中文）、en-US（英文）。/ Support : zh-CN 、 en-US

默认值:

zh-CN

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

access_code

string

必需

month

string

必需

查询的指定月份，格式为：YYYYMM
// Query a Specified month, YYYYMM

page_no

integer

必需

page_size

integer

最大支持100

必需

timestamp

string

必需

version

string

必需

sign

string

必需

示例

{
  "access_code": "P000270",
  "month": "202002",
  "page_no": 1,
  "page_size": 2,
  "timestamp": "1643253530",
  "version": "2.0",
  "sign": "LOBuk7VWZwWHvT1UBayqBR8pAvk="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-uat.io.linksfield.net/cube/v4/flow/totalMonthFlowList' \
--header 'Accept-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_code": "P000270",
    "month": "202002",
    "page_no": 1,
    "page_size": 2,
    "timestamp": "1643253530",
    "version": "2.0",
    "sign":"LOBuk7VWZwWHvT1UBayqBR8pAvk="
}'

返回响应

🟢200Success

application/json

Body

code

string

必需

data

object

必需

page

object

可选

分页信息，以便接入方系统判断，是否获取完毕所有的流量使用信息。如果ret_info=0000,该节点存在
// page info.

sign

string

必需

device_flow

array [object {2}]

可选

每个device_flow节点中包含一个流量使用情况信息；在响应报文中出现的device_flow节点数量要求与device_flow_list_num取值相同。若ret_info=0000,该节点存在；
// SIM card info.

device_flow_list_num

integer

可选

查询出的设备流量使用记录数量；若ret_info=0000,该节点信息存在，
//Indicates the number of queried device traffic usage records.

message

string

必需

success

boolean

必需

示例

{
  "code": "string",
  "data": {
    "page": {
      "cur_page_no": 0,
      "page_size": 0,
      "total_count": 0,
      "total_pages": 0
    },
    "sign": "string",
    "device_flow": [
      {
        "device_id": "string",
        "queryday_flow": "string"
      }
    ],
    "device_flow_list_num": 0
  },
  "message": "string",
  "success": true
}

修改于 2022-12-12 03:21:14

查询单日流量使用情况 / Example Query the daily usage

同步资费套餐 / Get data plan