查询消费记录

接口信息

URL: http://plugin.aiconductor.fun/api/users/transaction_query

方法: POST

Content-Type: application/json

鉴权: 请求头 Authorization: Bearer <api_key>（兼容 body/query 中 api_key 参数）

功能说明

根据 API 密钥查询交易记录，支持按交易类型、时间范围筛选及排序，支持分页（每页20条）。

请求参数

参数名	类型	必填	默认值	说明
page	int	否	1	页码
type	string	否	""	交易类型：`consume`（消费）、`recharge`（充值），不传则查全部
start_date	string	否	""	起始日期，格式 `YYYY-MM-DD`，如 `2026-01-01`
end_date	string	否	""	结束日期，格式 `YYYY-MM-DD`，如 `2026-05-14`
order	string	否	desc	排序方向：`asc`（升序）、`desc`（降序，默认）

鉴权参数：api_key 通过请求头 Authorization: Bearer <api_key> 传递，不再列入请求参数表。

响应参数

参数名	类型	说明
success	boolean	是否成功
message	string	响应消息
data	array	交易记录列表
data[].id	int	交易ID
data[].service_code	string	服务代码
data[].amount	float	交易金额（正数充值/负数消费）
data[].balance_after	float	交易后余额
data[].type	string	交易类型：`consume` / `recharge`
data[].notes	string	交易备注
data[].created_at	string	交易时间，格式 `YYYY-MM-DD HH:MM:SS`
pagination	object	分页信息
summary	object	金额汇总（不限当前分页，对所有符合条件的记录统计）
summary.total_consume	float	消费总额（取绝对值，始终 ≥ 0）
summary.total_recharge	float	充值总额（始终 ≥ 0）
pagination	object	分页信息
pagination.page	int	当前页码
pagination.page_size	int	每页条数（固定20）
pagination.total	int	筛选后总记录数
pagination.total_pages	int	总页数

请求示例

注意事项

所有筛选参数均可自由组合，不传则表示不限制该条件

start_date 和 end_date 可单独使用或同时使用，分别控制起始和截止时间

日期筛选为闭区间（含当天），start_date 从当天 00:00:00 起，end_date 到当天 23:59:59 止

支持 GET 方式传参（参数通过 query string 传递），但建议使用 POST + JSON 方式

当 page 超出总页数时返回错误，message 中会告知最大页码

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "success": true,
    "message": "查询成功",
    "data": [
        {
            "id": 1731101,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.0702,
            "balance_after": 483.3351,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:58:30"
        },
        {
            "id": 1731100,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.1938,
            "balance_after": 483.4053,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:58:09"
        },
        {
            "id": 1731099,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.0492,
            "balance_after": 483.5991,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:58:02"
        },
        {
            "id": 1731098,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 483.6483,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:54"
        },
        {
            "id": 1731097,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 483.6583,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:54"
        },
        {
            "id": 1731094,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.0267,
            "balance_after": 483.6683,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:50"
        },
        {
            "id": 1731093,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.0291,
            "balance_after": 483.695,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:50"
        },
        {
            "id": 1731092,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.0723,
            "balance_after": 483.7241,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:47"
        },
        {
            "id": 1731091,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 483.7964,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:45"
        },
        {
            "id": 1731090,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 483.8064,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:45"
        },
        {
            "id": 1731088,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.2892,
            "balance_after": 483.8164,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:42"
        },
        {
            "id": 1731087,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 484.1056,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:35"
        },
        {
            "id": 1731086,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 484.1156,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:35"
        },
        {
            "id": 1731085,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.2979,
            "balance_after": 484.1256,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:33"
        },
        {
            "id": 1731084,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.0609,
            "balance_after": 484.4235,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:31"
        },
        {
            "id": 1731083,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 484.4844,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:17"
        },
        {
            "id": 1731082,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 484.4944,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:17"
        },
        {
            "id": 1731081,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.0174,
            "balance_after": 484.5044,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:15"
        },
        {
            "id": 1731080,
            "service_code": "douyin_link_to_text_v2",
            "amount": -0.225,
            "balance_after": 484.5218,
            "type": "consume",
            "notes": "抖音链接转文字服务V2",
            "created_at": "2026-06-05 16:57:13"
        },
        {
            "id": 1731079,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 484.7468,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-06-05 16:57:12"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 20,
        "total": 4188,
        "total_pages": 210
    },
    "summary": {
        "total_consume": 166.0996,
        "total_recharge": 0
    }
}

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项