COST
扣费规则
每次请求按固定额度扣费，不随返回条数变化。
固定 2 点额度/次
实际扣费以响应头 x-api-cost 为准。
请求说明
参数
查询参数
yearinteger
可选的导出年份筛选；留空时自动选择最近可用月份。
示例：2026
monthinteger
可选的导出月份筛选；留空时自动选择最近可用月份。
示例：4
响应说明
状态码与响应格式
200
当前可用的导出日期和格式。
响应头
x-api-remainx-api-cost
application/jsonobject
响应结构
{
"type": "object",
"required": [
"ok",
"data",
"error"
],
"properties": {
"ok": {
"type": "boolean",
"required": true
},
"data": {
"type": "object",
"required": true,
"shape": {
"type": "object",
"required": [
"selectedYear",
"selectedMonth",
"availableYears",
"availableMonths",
"items"
],
"properties": {
"selectedYear": {
"type": "integer",
"required": true
},
"selectedMonth": {
"type": "integer",
"required": true
},
"availableYears": {
"type": "array<integer>",
"required": true,
"shape": {
"type": "array",
"items": {
"type": "integer"
}
}
},
"availableMonths": {
"type": "array<integer>",
"required": true,
"shape": {
"type": "array",
"items": {
"type": "integer"
}
}
},
"items": {
"type": "array<object>",
"required": true,
"shape": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"formats"
],
"properties": {
"date": {
"type": "string",
"required": true
},
"formats": {
"type": "array<csv | jsonl>",
"required": true,
"shape": {
"type": "array",
"items": {
"type": "csv | jsonl",
"enum": [
"csv",
"jsonl"
]
}
}
}
}
}
}
}
}
}
},
"error": {
"type": "string",
"required": true
}
}
}示例响应
{
"ok": true,
"data": {
"selectedYear": 2026,
"selectedMonth": 3,
"availableYears": [
2027,
2026,
2025
],
"availableMonths": [
3,
2,
1
],
"items": [
{
"date": "20260321",
"formats": [
"csv",
"jsonl"
]
}
]
},
"error": ""
}