创建 Webhook
POST/webhooks
注册一个 HTTPS Webhook 端点以接收事件通知。响应会返回创建的目标及其 signing_secret。
签名密钥只显示一次——请立即保存;之后无法再获取。 用它验证收到的 Webhook 投递的签名。
在此创建的 Webhook 会启用 order.status_changed;其他事件遵循 Webhook 事件 中列出的按事件默认值。
要求:
- 你的账户需要超过 1 TRX 的净确认充值(已确认的充值减去提现,含提现手续费)。购买不会减少该数值;提现会减少。
- URL 必须使用 HTTPS,且其主机只能解析到公网 IP 地址(
localhost、*.local和tronagg.ai主机会被拒绝)。每次投递前都会再次检查主机。 - 不跟随重定向。URL 末尾的
/会被去掉。 - 每个 URL 只能注册一个 Webhook,每个账户最多 10 个 Webhook。
请求
Responses
- 201
- 400
- 422
Webhook 已创建。signing_secret 只在此处返回。
无法创建 Webhook。detail.error 为以下之一:
validation_error——URL 未使用 HTTPS、没有主机、是tronagg.ai主机、其主机无法解析或不只解析到公网 IP 地址;该 URL 已连接到你的账户;或你的账户已有 10 个 Webhook。detail.message会说明是哪一种。webhook_deposit_required——你的账户的净确认充值尚未超过 1 TRX。响应体还带有total_deposited_sun(你当前的净确认充值,单位 SUN:已确认的充值减去提现(含提现手续费),最低为 0)和required_total_deposited_sun(1000001)。两者均为整数。
校验错误