reseller

POST `/v1/reseller/ai/credits/clients/{org_id}`

Give one of your clients AI credit, or take unspent credit back.

Xác thực

Gửi khóa API dưới dạng mã thông báo bearer. Khóa này phải có quyền reseller.manage; khóa không có quyền này sẽ bị từ chối với mã lỗi 403, không phải 404.

Nơi điền id tổ chức của bạn

Endpoint này nhận mã tổ chức của bạn trực tiếp trong URL dưới dạng org_id. Hãy thay thế nó vào đường dẫn — không có header hoặc query parameter nào có thể thay thế được.

Mã tổ chức của bạn nằm ở màn hình khóa API trong bảng điều khiển, ngay bên cạnh khóa đó. Đây là cùng một mã trong mọi lệnh gọi mà bạn thực hiện.

Dùng thử

Thay thế bất kỳ nội dung nào trong ngoعل (angle brackets) bằng giá trị của riêng bạn và trình giữ chỗ key bằng một key từ trang tổng quan của bạn.

curl -X POST https://api.zinndigital.com/v1/reseller/ai/credits/clients/{org_id} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "delta_micros": <integer>, "reason": <string> }'

Đã đăng nhập? Bảng điều khiển API trong trang quản lý của bạn sẽ tự điền ID tổ chức thực tế và khóa của riêng bạn, sau đó chạy yêu cầu đối với API trực tiếp để bạn có thể xem phản hồi thực tế. Mở điểm cuối này trong bảng điều khiển API

Chi tiết

Moves credit between your pool and one client's balance in one transaction: a positive `delta_micros` gives, a negative one takes back. A client who has already **spent** the credit cannot be taken below zero — the request is refused and names what is left. A client that is not yours is refused with the same code and message as one that does not exist, so this cannot be used to discover whether an organization id is real. This is the manual route, for a trial, a goodwill gesture, or a bundle sold offline. The self-serve route is your client buying a pack from you, which draws on the same pool. Requires `reseller.manage`.

Tham số

Tên	Loại	Bắt buộc	Nội dung này là gì
`org_id (path)`	`Uuid`	Có	The client organization whose balance moves. Must be one of yours.
`org_id (query)`	`Uuid`	Không	Which of YOUR organizations is acting. Not the client.

Nội dung yêu cầu

Tên	Loại	Bắt buộc	Nội dung này là gì
`delta_micros`	`integer`	Có	Signed USD micros. Positive gives credit to the client, negative takes unspent credit back. Zero is refused — a ledger row that means nothing.
`reason`	`string`	Có	Why. Required, for the same reason a staff adjustment requires one: a movement of somebody's money with no stated cause is unanswerable three months later.

Phản hồi

Tên	Loại	Bắt buộc	Nội dung này là gì
`pool_balance_micros`	`integer`	Có	—
`client_balance_micros`	`integer`	Có	—
`typical_calls`	`integer`	Có	Roughly how many AI questions the client's new balance buys. An illustration — a long article costs many times a short question.

Các lỗi điểm cuối này có thể trả về

401 · 403 · 404 · 422 · 429