Chuyển đến nội dung
HILLS API v1

Tham chiếu API

Thanh toán

Số dư của bạn tại HILLS Music và các yêu cầu rút tiền của bạn.

Số dư của bạn tại HILLS Music và các yêu cầu rút tiền của bạn.

Base URL https://api.hillsmusic.com/v1. Mọi request đều gửi một API key: Authorization: Bearer hm_live_….

  • Số dư và thanh toán

Số dư và thanh toán

GET /v1/payouts · Scope: payouts:read

Số dư của bạn tại HILLS Music (tính bằng cent) và các yêu cầu rút tiền, mới nhất trước.

Ví dụ request

curl "https://api.hillsmusic.com/v1/payouts" \
  -H "Authorization: Bearer $HILLS_API_KEY"

Phản hồi 200

{
  "balance": {
    "currency": "USD",
    "earned_cents": 254000,
    "reserved_cents": 100000,
    "paid_cents": 100000,
    "manual_cents": 0,
    "available_cents": 154000
  },
  "data": [
    {
      "id": 9,
      "amount_cents": 100000,
      "currency": "USD",
      "status": "completed",
      "failed_reason": null,
      "created_at": "2026-09-01T09:00:00Z",
      "approved_at": "2026-09-02T09:00:00Z",
      "completed_at": "2026-09-04T09:00:00Z"
    }
  ]
}

Lỗi

Mã trạng thái Khi nào
401 unauthenticated, invalid_key, key_revoked, key_expired hoặc test_keys_retired.
403 insufficient_scope: key thiếu scope; scope cho biết scope nào. account_inactive hoặc api_not_in_plan.
429 rate_limited: chờ số giây ghi trong Retry-After.

Sẵn sàng tích hợp?

Đăng ký quyền truy cập API, chúng tôi sẽ phản hồi bạn trong vòng 1–3 ngày làm việc.