API 与 Webhook

通过接口可将独享 IP 接入你自己的系统：查询列表和用量、下单、换 IP、购买流量包；开通、流量、到期等状态变化通过 Webhook 推送给你。购买独享 IP 后即可使用，各接口的参数和示例见接口文档。

创建密钥

1. 1
   在网站用户中心「独享 IP」中打开「API 与 Webhook」，新建密钥。
2. 2
   选择权限：「只读」仅可查询列表、详情、用量和订单；「可下单」还可下单、换 IP、购买流量包，相关费用从余额扣除。
3. 3
   填写 IP 白名单，不在名单内的地址无法使用该密钥。

• 最多可创建 3 个密钥。
• 如怀疑密钥泄露，可停用后重新创建，旧密钥将立即作废。

调用

• 密钥放在请求头中：Authorization: Bearer 你的密钥。
• 每个账户每分钟最多调用 60 次，超出时返回 429。
• 使用可下单密钥下单时，如余额不足将返回 402，订单会保留，充值到账后自动完成。

Webhook

1. 1
   在「API 与 Webhook」中填写回调地址，并勾选需要接收的事件：开通完成、流量达到阈值、流量用完已暂停、即将到期、已到期进入宽限期、宽限期满已收回、自动续费扣款未成功、月度账单已生成。
2. 2
   每个回调地址拥有独立的签名密钥。每次推送均带有 X-PDVPN-Signature 请求头，收到后请按接口文档验证签名，验证通过后再处理。
3. 3
   如你的地址未返回 2xx，视为推送未送达，最多重试 5 次。同一事件可能收到多次，请使用事件的 id 去重。