PartnerBoost 商户 API

您可以使用 curl 调用 PartnerBoost 商户 API。所有请求都需要在请求头中添加 X-Api-Key 进行身份验证。

请联系客户成功经理获取 API 密钥。

设置

OpenClaw（以及兼容的客户端如 QClaw）决定了配置的存放位置以及密钥的注入方式。本技能不提供规范的配置文件、布局或 JSON 格式——您只需在 API 调用运行时，在进程环境中设置 PARTNERBOOSTAPIKEY 环境变量即可。请按照您客户端的官方说明进行配置。

身份验证

每个请求必须包含：

-H X-Api-Key: $PARTNERBOOSTAPIKEY

基础 URL

https://app.partnerboost.com

API 模式

所有 WebUI API 遵循以下模式：

• - GET: curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY https://app.partnerboost.com/a/{controller}/{action}?param1=value1¶m2=value2
• POST: curl -s -X POST -H X-Api-Key: $PARTNERBOOSTAPIKEY -H Content-Type: application/json -d {key:value} https://app.partnerboost.com/a/{controller}/{action}

响应格式

所有 API 返回 JSON 格式：{ code: 0, message: ok, data: ... }。code 为 0 表示成功。

分页响应包含以下字段：totalsize、totalpage、pagesize、pagenum、current_size。

1. 订单

1.1 查询订单列表

根据筛选条件查询订单。支持分页和排序。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/transaction/list3?pagenum=1&pagesize=20&startdate=1735689600&enddate=1741737600

参数（均为可选）：

• - pagenum（整数）：页码，默认为 1
• pagesize（整数）：每页条数，默认为 20
• startdate（整数）：开始时间，Unix 时间戳（10 位数字）
• enddate（整数）：结束时间，Unix 时间戳（10 位数字）
• mediumid（字符串）：按媒体 ID 筛选
• status（字符串）：订单状态
• searchword（字符串）：搜索关键词
• sorttype（字符串）：排序字段
• sortorder（字符串）：升序或降序

1.2 订单统计

获取订单统计摘要。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/transaction/liststats?startdate=2026-01-01&end_date=2026-03-12

参数（均为可选）：

• - startdate、enddate、medium_id、status——同上

1.3 最近订单

获取最近 10 条订单。无需参数。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/transaction/nearly_list

2. 业绩

2.1 业绩图表

获取业绩图表数据（点击量、订单数、佣金趋势）。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/performance/chartsv2?startdate=1735689600&enddate=1741737600&groupby=day

参数：

• - startdate（整数，必填）：Unix 时间戳（10 位数字）
• enddate（整数，必填）：Unix 时间戳（10 位数字）
• groupby（字符串）：按天、周或月分组。默认：按天
• mediumid（字符串）：按媒体 ID 筛选
• channel（字符串）：按渠道筛选
• partnergroupid（整数）：按合作伙伴分组筛选

2.2 业绩列表

获取带分页的业绩详情列表。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/performance/listv2?startdate=1735689600&enddate=1741737600&pagenum=1&page_size=20

参数：

• - startdate（整数，必填）：Unix 时间戳（10 位数字）
• enddate（整数，必填）：Unix 时间戳（10 位数字）
• pagenum、pagesize
• groupby（字符串）：按天、周、月、媒体或渠道分组
• mediumid、channel、partnergroupid——与图表相同
• sorttype（字符串）：排序字段
• sortorder（字符串）：升序或降序

2.3 业绩总计

获取业绩汇总总计。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/performance/chartstotal?startdate=1735689600&end_date=1741737600

参数：

• - startdate（整数，必填）：Unix 时间戳（10 位数字）
• enddate（整数，必填）：Unix 时间戳（10 位数字）
• mediumid、channel、partnergroup_id

2.4 搜索合作伙伴业绩

在业绩报告中按关键词搜索合作伙伴。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/performance/search_partner?word=keyword

参数：

• - word（字符串，必填）：搜索关键词

3. 结算

3.1 结算列表

获取带筛选条件的结算记录。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/account/billinglist?pagenum=1&page_size=20

参数（均为可选）：

• - pagenum、pagesize
• mid（字符串）：媒体 ID
• ids（字符串）：结算 ID，以逗号分隔
• timestart（整数）：开始时间，Unix 时间戳
• timeend（整数）：结束时间，Unix 时间戳
• paymentmethod、paymenttype、status、search_word

3.2 账户信息

获取账户信息，包括余额。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/account/account_info

3.3 当前套餐

获取当前订阅套餐详情。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/account/current_plan

3.4 预付款列表

获取预付款记录。

bash
curl -s -H X-Api-Key: $PARTNERBOOSTAPIKEY \
https://app.partnerboost.com/a/account/prepayment?pagenum=1&page_size=20

参数（均为可选）：pagenum、pagesize、mid、timestart、timeend