# ICCID流量查询接口

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v3/cdr/traffic/query:
    post:
      summary: ICCID流量查询接口
      deprecated: false
      description: 该接口实际是查询运营商推送的cdr文件，非实时流量
      tags:
        - API接口/CDR
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                appkey:
                  type: string
                  description: >-
                    appkey平台用以确定客户端应用的身份。应用键对应一个密钥 secret。要基于服务平台开发应用，必须事先通过申请获取
                    appkey/secret 后，才能进行应用的开发。
                  title: appkey
                  x-apifox-mock: '{{APPKEY}}'
                timestamp:
                  type: integer
                  description: 当前时间戳，10位数字
                  x-apifox-mock: '{{TIMESTAMP}}'
                nonce:
                  type: string
                sign:
                  type: string
                  x-apifox-mock: '{{SIGN}}'
                  description: 签名串，请求参数的签名，服务平台通过它验证请求数据的合法性。
                dateType:
                  type: string
                  description: 时间类型，按天：daily，按月：monthly
                  title: 时间类型
                iccids:
                  type: string
                  description: iccid卡号，用英文逗号隔开
                startDate:
                  type: string
                  description: 按天查询时必填，开始时间，格式yyyy-MM-dd
                endDate:
                  type: string
                  description: 按天查询时必填，结束时间，格式yyyy-MM-dd
                month:
                  type: string
                  description: 按月查询时必填，月份，格式yyyy-MM，如2026-01
              x-apifox-orders:
                - appkey
                - timestamp
                - nonce
                - sign
                - dateType
                - iccids
                - startDate
                - endDate
                - month
              required:
                - appkey
                - timestamp
                - nonce
                - sign
                - dateType
                - iccids
                - startDate
                - endDate
                - month
            example: "{\r\n    \"appkey\": \"{{APPKEY}}\",\r\n    \"timestamp\": {{TIMESTAMP}},\r\n    \"nonce\": 49890,\r\n    \"sign\": \"{{SIGN}}\",\r\n\r\n    \"dateType\":\"daily\",\r\n    \"iccids\":\"8932042000009789134,8932042000001778197\",\r\n    \"startDate\":\"2026-01-01\",\r\n    \"endDate\":\"2026-01-02\"\r\n}"
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        iccid:
                          type: string
                          description: 有流量的iccid
                        traffic:
                          type: string
                          description: 流量，单位Byte
                      x-apifox-orders:
                        - iccid
                        - traffic
                      required:
                        - iccid
                        - traffic
                x-apifox-orders:
                  - code
                  - message
                  - data
                required:
                  - code
                  - message
                  - data
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: API接口/CDR
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/2330898/apis/api-409777084-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://oapi.eiotclub.com
    description: 生产环境
security: []

```
