inquireCardTransactionLifecycle
此 API 用于查询按 lifecycleId 分组或使用通用生命周期 ID 分组的卡消费记录。每行包含事件总额、最新事件状态和卡上下文，用于列表渲染和高层对账。您可以使用 notifyCardBill，该接口提供 orderNo 作为 lifecycleId，用于查询对应数据。
入参
startTime Datetime
开始时间。transactionTime 的可选下限。
注意：
- 如果仅提供 startTime，则查询从 startTime 起的记录。
- 如果省略，则不设时间下限。
- 如果日期时间无效，或值超过最大 100 天范围，则返回错误码
PARAM_ILLEGAL。
更多信息：
- 最大长度：32 字符
- 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。
endTime Datetime
结束时间。transactionTime 的可选上限。
注意：
- 如果仅提供 endTime，则查询到 endTime 为止的记录。
- 如果省略，则不设时间上限。
- 如果日期时间无效，或值超过最大 100 天范围，则返回错误码
PARAM_ILLEGAL。
更多信息：
- 最大长度：32 字符
- 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。
assetIdList Array
卡资产 ID 列表。
最大数量：20 个元素，每个最大长度为 32。
注意：如果省略，该参数显示所有卡资产 ID。
lifecycleIdList Array
生命周期 ID 列表。
最大数量：20，每个 ≤ 64
注意：如果省略，该参数显示所有生命周期 ID。
pageSize Integer
每页条数。
注意：该参数无默认值。如果缺失、为空或超出范围，则返回错误码 PARAM_ILLEGAL。
更多信息：
- 值范围： [1, 100]
pageNumber Integer
从 1 开始的页码。
注意：该参数无默认值。如果缺失、为空或超出范围，则返回错误码 PARAM_ILLEGAL。
更多信息：
- 值范围： [1, 10000]
出参
result Result REQUIRED
接口调用的结果。
lifecycles Array<CardTransactionLifecycle>
消费汇总。
注意：
- 当 resultStatus 为
S时返回此参数。 - 此参数当查询无匹配结果时返回空数组。
更多信息：
- 最多可包含元素个数：100
totalCount Integer
请求处理时匹配记录的总数。
注意：
- 当 resultStatus 为
S时返回此参数。 - 如果无匹配记录，该值为
0。
更多信息：
- 值范围： [0, +∞)
totalPageNumber Integer
总页数，计算公式为 ceil(totalCount/pageSize)。
注意：
- 当 resultStatus 为
S时返回此参数。 - 若无匹配记录，该值为
0。
更多信息：
- 值范围： [0, +∞)
currentPageNumber Integer
当前从 1 开始的页码，与请求的 pageNumber 一致。
注意：当 resultStatus 的值为 S 时返回此参数。
更多信息：
- 值范围： [1, 10000]
请求
响应
结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功 | 无需进一步操作。 |
| PARAM_ILLEGAL | F | 存在非法参数。例如，非数字输入或无效日期。 | 检查并验证请求参数（包括头参数和体参数）是否正确有效。有关各接口参数的详细信息，请参见相应接口结构章节。 |
| ACCESS_TOKEN_EXPIRED | F | 访问令牌已过期。 | 刷新令牌以获取新的访问令牌，或联系 Antom 技术支持团队处理。 |
| UNKNOWN_EXCEPTION | U | 接口因未知原因失败。 | 服务可能不可用，请稍后重试。如果问题持续存在，请联系 Antom 技术支持团队。 |
| PROCESS_FAIL | F | 发生一般业务失败。 | 请勿重试。通常需要人工干预。建议您联系 Antom 技术支持团队解决问题。 |
| CONTRACT_NOT_EXIST | F | 合约检查失败。 | 请确保合作方已签署合约且输入正确。 |
| USER_NOT_EXIST | F | 用户不存在。 | 使用正确的用户信息重试。 |