API 文档

认证

所有请求需在 Header 中携带 API Key(后台「开发者设置」中生成)。速率限制:600 次 / 分钟。

Authorization: Bearer ztad_live_xxxxxxxxxxxxxxxx

GET获取 Offer 列表

GET https://api.ztad.com/v1/offers?category=finance&geo=US&page=1

{
  "data": [
    {
      "id": "of_9x72ka",
      "name": "全球消费信贷 CPA",
      "category": "finance",
      "payout": 42.00,
      "model": "CPA",
      "geos": ["US", "CA", "UK", "AU"],
      "devices": ["desktop", "mobile"],
      "tracking_url": "https://track.ztad.com/click?of=of_9x72ka&aff={AFF_ID}&sub1={SUB1}"
    }
  ],
  "page": 1,
  "total": 6231
}

GET查询报表

支持按日期区间、Offer、子 ID 维度查询点击、转化、收入。

GET https://api.ztad.com/v1/reports?from=2026-09-01&to=2026-09-07&group_by=offer

{
  "data": [
    { "offer_id": "of_9x72ka", "clicks": 18240, "conversions": 1497,
      "cr": 8.2, "revenue": 62874.00, "epc": 3.44 }
  ]
}

Webhook转化实时推送

配置回调地址后,每次转化将以 POST JSON 推送,含 HMAC-SHA256 签名校验头。

POST https://your-domain.com/ztad-webhook
X-ZTAD-Signature: sha256=...

{
  "event": "conversion.approved",
  "offer_id": "of_9x72ka",
  "sub1": "campaign_summer",
  "payout": 42.00,
  "ts": 1760000000
}

S2SPostback 回传

若你的系统需要接收回传,在 Offer 追踪链接中使用宏并填写 Postback URL。

https://track.ztad.com/postback?cid={CLICK_ID}&payout={PAYOUT}&sub1={SUB1}

错误码

400 invalid_parameter  参数错误
401 unauthorized       API Key 缺失或失效
403 forbidden          无权访问该资源
429 rate_limited       超出速率限制
500 server_error       服务端异常,请稍后重试

接入遇到问题?请访问支持中心或写信到 support@ztad.com,我们的工程团队会在一个工作日内回复。