查询消费记录

接口信息

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	分页信息
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": 1578777,
            "service_code": "douyin_single_video_comment_get",
            "amount": -0.01,
            "balance_after": 730.4077,
            "type": "consume",
            "notes": "抖音视频评论获取服务",
            "created_at": "2026-05-14 15:39:39"
        },
        {
            "id": 1578775,
            "service_code": "douyin_video_info_max",
            "amount": -0.01,
            "balance_after": 730.4177,
            "type": "consume",
            "notes": "抖音视频详情获取服务",
            "created_at": "2026-05-14 15:39:10"
        },
        {
            "id": 1573749,
            "service_code": "url_to_markdown",
            "amount": -0.01,
            "balance_after": 730.4277,
            "type": "consume",
            "notes": "URL转Markdown服务",
            "created_at": "2026-05-13 15:13:05"
        },
        {
            "id": 1566889,
            "service_code": "video_download_url_oss",
            "amount": -0.01,
            "balance_after": 730.4377,
            "type": "consume",
            "notes": "视频下载URL解析服务(OSS版)",
            "created_at": "2026-05-12 17:15:09"
        },
        {
            "id": 1566854,
            "service_code": "video_download_url_oss",
            "amount": -0.01,
            "balance_after": 730.4477,
            "type": "consume",
            "notes": "视频下载URL解析服务(OSS版)",
            "created_at": "2026-05-12 17:13:58"
        },
        {
            "id": 1566827,
            "service_code": "video_download_url_oss",
            "amount": -0.01,
            "balance_after": 730.4577,
            "type": "consume",
            "notes": "视频下载URL解析服务(OSS版)",
            "created_at": "2026-05-12 17:12:33"
        },
        {
            "id": 1564963,
            "service_code": "video_download_url_oss",
            "amount": -0.01,
            "balance_after": 730.4677,
            "type": "consume",
            "notes": "视频下载URL解析服务(OSS版)",
            "created_at": "2026-05-12 15:11:04"
        },
        {
            "id": 1564948,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 730.4777,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-05-12 15:09:55"
        },
        {
            "id": 1564893,
            "service_code": "video_download_url_oss",
            "amount": -0.01,
            "balance_after": 730.4877,
            "type": "consume",
            "notes": "视频下载URL解析服务(OSS版)",
            "created_at": "2026-05-12 15:04:56"
        },
        {
            "id": 1564762,
            "service_code": "video_download_url_oss",
            "amount": -0.01,
            "balance_after": 730.4977,
            "type": "consume",
            "notes": "视频下载URL解析服务(OSS版)",
            "created_at": "2026-05-12 14:56:45"
        },
        {
            "id": 1564414,
            "service_code": "video_download_url_oss",
            "amount": -0.01,
            "balance_after": 730.5077,
            "type": "consume",
            "notes": "视频下载URL解析服务(OSS版)",
            "created_at": "2026-05-12 14:40:31"
        },
        {
            "id": 1557317,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 730.5177,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-05-11 12:01:26"
        },
        {
            "id": 1557316,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 730.5277,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-05-11 12:00:37"
        },
        {
            "id": 1557313,
            "service_code": "Get_Download_Url",
            "amount": -0.01,
            "balance_after": 730.5377,
            "type": "consume",
            "notes": "视频下载URL解析服务",
            "created_at": "2026-05-11 11:58:57"
        },
        {
            "id": 1557307,
            "service_code": "douyin_video_info_max",
            "amount": -0.01,
            "balance_after": 730.5477,
            "type": "consume",
            "notes": "抖音视频详情获取服务",
            "created_at": "2026-05-11 11:56:33"
        },
        {
            "id": 1553593,
            "service_code": "xhs_note_info_v3",
            "amount": -0.15,
            "balance_after": 730.5577,
            "type": "consume",
            "notes": "小红书笔记详情获取服务",
            "created_at": "2026-05-10 15:25:59"
        },
        {
            "id": 1553513,
            "service_code": "xhs_note_info_v3",
            "amount": -0.15,
            "balance_after": 730.7077,
            "type": "consume",
            "notes": "小红书笔记详情获取服务",
            "created_at": "2026-05-10 12:48:22"
        },
        {
            "id": 1552976,
            "service_code": "md_to_html",
            "amount": -0.01,
            "balance_after": 730.8577,
            "type": "consume",
            "notes": "Markdown转HTML网页服务",
            "created_at": "2026-05-10 09:00:19"
        },
        {
            "id": 1552974,
            "service_code": "md_to_html",
            "amount": -0.01,
            "balance_after": 730.8677,
            "type": "consume",
            "notes": "Markdown转HTML网页服务",
            "created_at": "2026-05-10 09:00:18"
        },
        {
            "id": 1551204,
            "service_code": "publish_webpage",
            "amount": -0.01,
            "balance_after": 730.8777,
            "type": "consume",
            "notes": "HTML网页发布服务",
            "created_at": "2026-05-09 22:51:20"
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 20,
        "total": 161660,
        "total_pages": 8083
    }
}

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项