钱包交易汇总

此端点返回指定日期范围内的钱包金额汇总，而非逐条交易记录。当您只需要总额，而不想翻页遍历钱包交易记录列表再自行累加时，请使用此端点。

端点

方法	URL
GET	https://ws.catappult.io/api/wallet/transactionsTotals

身份验证

要访问此 API，您需要在 Aptoide Connect 上拥有有效的帐户订阅，并使用 API 密钥进行身份验证（请查看此处了解如何生成密钥）。

请求头

请求头	类型	是否必需	说明
Api-Key	string	必需	用于对您的 API 请求进行身份验证。该值是您的 Aptoide Connect API 密钥。

查询参数

参数	类型	是否必需	说明
from	string (YYYY-MM-DD)	必需	时间范围的开始日期。示例：2024-01-01。
to	string (YYYY-MM-DD)	必需	时间范围的结束日期。示例：2024-01-31。
packageName	string	可选	按应用包名筛选结果。示例：com.example.test。
countryCode	string	可选	按国家/地区筛选结果，使用 ISO 3166-1 alpha-2 格式。示例：PT。
operatingSystem	string	可选	按平台筛选结果。可选值：android、ios。
type	string	可选（默认：all）	按交易类型筛选结果。可选值：all、debit、credit。
paymentMethod	string	可选	将结果限定为沙盒测试购买。唯一接受的值为：sandbox。
amountType	string	可选（默认：wallet）	指定返回净额还是总额。可选值：wallet（净额，即实际到账您钱包的金额）或 global（总额）。

响应

成功

如果 API 调用返回 HTTP 200 状态码，则表示请求成功，并返回所请求范围内以美元计的汇总金额。

字段	类型	说明
iap	object	应用内购买收入，格式为 { "usd": number }。
credit	object	计入钱包的总金额，格式为 { "usd": number }。
debit	object	从钱包扣除的总金额，格式为 { "usd": number }。

响应示例

{
    "credit": {
        "usd": 103.8
    },
    "debit": {
        "usd": 0
    },
    "iap": {
        "usd": 103.8
    }
}

💡

净额与总额是不同的数字

默认情况下，这些是计入您钱包的金额，已扣除增值税和收入分成。传入 amountType=global 返回的是含增值税的消费者总支出，数值会明显更大。二者的差额随买家所在国家/地区而变化，因此请勿将 global 汇总值与默认值对比，并把差额视为缺失的收入。

错误

代码	HTTP 状态	说明	解决方法
—	401 Unauthorized	API 密钥无法识别	请检查密钥，以及帐户是否已通过审核
SUBSCRIPTION-REQUIRED	402 Payment Required	没有有效的帐户订阅	请为该帐户开通订阅
DAILY-QUOTA-REACHED	429 Too Many Requests	超出每日请求配额	请在 UTC 午夜配额重置后重试