SuperAPI AI 工具集

billing

部署与运维

查看项目

更新于 10-15 22:14

技能介绍

用途:Hostinger Billing API 提供对 Hostinger 服务目录、支付方式和订阅的编程式管理,适合在自有系统中查询价格、管理付款方式与自动续费。

主要能力:

  1. 目录:GET /api/billing/v1/catalog 获取可购产品与价格,可按 category、name 过滤。价格以整数分表示,如 1799 即 17.99 美元,展示前需除以 100 并格式化。
  2. 支付方式:GET /api/billing/v1/payment-methods 列出;POST /api/billing/v1/payment-methods/{id} 设为默认;DELETE /api/billing/v1/payment-methods/{id} 删除。新增支付方式必须通过 hPanel,API 不支持。
  3. 订阅:GET /api/billing/v1/subscriptions 列出;DELETE /api/billing/v1/subscriptions/{id}/auto-renewal/disable 关闭自动续费;PATCH /api/billing/v1/subscriptions/{id}/auto-renewal/enable 开启。

下单方式:通用 POST /api/billing/v1/orders 已移除。域名购买用 POST /api/domains/v1/portfolio,VPS 购买用 POST /api/vps/v1/virtual-machines,需引用目录 item_id 与支付方式。API 创建的订单默认自动续费;部分信用卡支付可能需额外验证。未指定支付方式时自动使用默认方式。

调用示例(curl): curl -X GET "https://developers.hostinger.com/api/billing/v1/catalog" -H "Authorization: Bearer $HOSTINGER_API_TOKEN" -H "Content-Type: application/json"

SDK:提供 Python(hostinger_api)、TypeScript(hostinger-api-sdk)、PHP(Hostinger\Api\HostingerApi)SDK 及 CLI 工具。

限制与排错:401 表示令牌无效或过期,令牌权限与所属用户一致;422 多为 item_id 或 payment_method_id 无效;429 为超出速率限制,需退避重试,反复违规可能临时封禁 IP。建议优先使用非信用卡支付方式以避免验证延迟,并在到期前及时关闭自动续费。

适用场景:需要程序化查询 Hostinger 价格、统一管理付款方式与订阅续费状态的开发者与运维人员。