Java

Java 对接

HttpClient 发请求、读 code/data，以及 QPS 限速。

发请求

Java 11 及以上用 JDK 自带 HttpClient。密钥放环境变量 APIZERO_KEY，请求头写 Authorization: Bearer。也认 X-API-Key。不要把 Key 写进前端或安装包。

主机是 https://v1.apizero.cn，路径带 /api/。GET 参数拼在 URL，POST 用 JSON。换接口只改路径和参数。

  • Authorization: Bearer <YOUR_KEY>
  • GET https://v1.apizero.cn/api/ip

读字段

统一外壳：code / msg / data / request_id。code 为 0 才成功，业务字段只在 data。提工单带上 request_id。

QPS 和额度

限流按 Key × 接口。具体数字看该接口详情页。打太快是 HTTP 429、业务码 4029，按 Retry-After 停 1 秒。日额度用完是 4030。点数或余额不够是 HTTP 402、业务码 4022，去订单充值，不要换 Key。