# 查询卡片套餐订购记录

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v3/package/packageOrderRecord:
    post:
      summary: 查询卡片套餐订购记录
      deprecated: false
      description: |+
        根据卡号，获取该卡片的套餐订购记录

      tags:
        - API接口/卡业务接口
        - 通用
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              title: ''
              type: object
              properties:
                appkey:
                  type: string
                  default: '{{APPKEY}}'
                  description: >-
                    appkey平台用以确定客户端应用的身份。应用键对应一个密钥 secret。要基于服务平台开发应用，必须事先通过申请获取
                    appkey/secret 后，才能进行应用的开发。
                  x-apifox-mock: '{{APPKEY}}'
                timestamp:
                  type: integer
                  description: 当前时间戳，10位数字
                nonce:
                  type: integer
                  minimum: 10000
                  maximum: 99999
                  description: 5位随机正整数
                sign:
                  type: string
                  description: 签名串，请求参数的签名，服务平台通过它验证请求数据的合法性。
                  x-apifox-mock: '{{SIGN}}'
                iccid:
                  type: string
                  description: 卡片的ICCID
                state:
                  type: integer
                  description: |-
                    套餐使用状态 0:待使用 1:使用中 2:已完成
                    0 待使用：后续会生效的套餐；
                    1 使用中：目前在用的套餐；
                    2 已完成：已完成的套餐包括退款、用完等情况；
                createDateStart:
                  type: string
                  description: 订购开始时间
                createDateEnd:
                  type: string
                  description: 订购结束时间
                orderIdArrStr:
                  type: string
                  description: 订单 id组字符串。例如 10004996,10004200
                page:
                  type: integer
                  description: 页码。从1开始
                pageSize:
                  type: integer
                  description: 页大小
                updateDateStart:
                  type: string
                  description: 数据更新开始时间
                updateDateEnd:
                  type: string
                  description: 数据更新结束时间
                orderBy:
                  type: string
                  description: '为空的情况默认是按创建时间升序，支持的枚举有: createDateDesc按创建时间倒序'
                stateArrStr:
                  type: string
                  description: 套餐使用状态字符串。例如 0,1
              x-apifox-orders:
                - appkey
                - timestamp
                - nonce
                - sign
                - iccid
                - state
                - createDateStart
                - createDateEnd
                - updateDateStart
                - updateDateEnd
                - orderIdArrStr
                - page
                - pageSize
                - orderBy
                - stateArrStr
              required:
                - appkey
                - timestamp
                - nonce
                - sign
                - iccid
            example:
              appkey: '{{APPKEY}}'
              timestamp: '{{TIMESTAMP}}'
              nonce: 95977
              sign: '{{SIGN}}'
              iccid: '8988308650104486856'
              state: 2
              createDateStart: '2024-07-15 16:28:06'
              createDateEnd: '2025-03-03 18:42:59'
              updateDateStart: '2025-02-10 20:23:30'
              updateDateEnd: '2025-02-10 20:23:38'
              orderIdArrStr: 10004996,10004997
              page: 1
              pageSize: 2
              stateArrStr: 0,1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: 200：表示成功其他失败
                  message:
                    type: string
                    description: 成功或失败原因
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        packageName:
                          type: string
                          description: 套餐名称
                        iccid:
                          type: string
                          description: 卡号
                        state:
                          type: integer
                          description: |-
                            套餐使用状态 0:待使用 1:使用中 2:已完成
                            0 待使用：后续会生效的套餐；
                            1 使用中：目前在用的套餐；
                            2 已完成：已完成的套餐包括退款、用完等情况；
                        price:
                          type: number
                          description: 订购价格
                          format: float64
                        createDate:
                          type: string
                          description: 订购时间
                        startDate:
                          type: string
                          description: 套餐开始时间
                        endDate:
                          type: string
                          description: |
                            套餐结束时间
                        flowTotal:
                          type: number
                          description: 套餐总流量
                          format: float64
                        gzhPackageName:
                          type: string
                          description: 商品套餐名称
                        totalActive:
                          type: integer
                          description: 有效时长, 以periodType的值为单位
                        currency:
                          type: string
                          description: 币种
                        orderId:
                          type: integer
                          description: 套餐订单号
                        packageCode:
                          type: string
                          description: 套餐编码
                        renew:
                          type: integer
                          description: 0 正常订单 1续订订单
                        packageType:
                          type: integer
                          description: 套餐类型：2 限量流量包 3 限时流量包 4 限时限速包
                        isRefund:
                          type: integer
                          description: 是否退订 0 未退订 1 已退订
                        periodType:
                          type: integer
                          description: 有效期类型  1:月 2:天
                        outTradeNo:
                          type: string
                          description: API调用方传入的唯一订单号标识 最大32位
                        updateDate:
                          type: string
                          description: 数据更新时间
                        flowRemain:
                          type: number
                          format: float64
                          description: 套餐剩余量
                        flowUsageBytes:
                          type: integer
                          description: 套餐用量, 单位Bytes
                      required:
                        - packageName
                        - iccid
                        - state
                        - price
                        - createDate
                        - startDate
                        - endDate
                        - flowTotal
                        - gzhPackageName
                        - totalActive
                        - currency
                        - orderId
                        - packageCode
                        - renew
                        - packageType
                        - isRefund
                        - periodType
                        - updateDate
                        - flowRemain
                        - flowUsageBytes
                      x-apifox-orders:
                        - orderId
                        - packageName
                        - packageCode
                        - iccid
                        - state
                        - price
                        - currency
                        - createDate
                        - updateDate
                        - startDate
                        - endDate
                        - flowTotal
                        - flowRemain
                        - flowUsageBytes
                        - gzhPackageName
                        - totalActive
                        - renew
                        - packageType
                        - isRefund
                        - periodType
                        - outTradeNo
                  total:
                    type: integer
                    description: 总数
                required:
                  - code
                  - message
                  - data
                  - total
                x-apifox-orders:
                  - code
                  - message
                  - total
                  - data
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: API接口/卡业务接口
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/2330898/apis/api-63600563-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://oapi.eiotclub.com
    description: 生产环境
security: []

```
