reseller

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

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

Pagpapatotoo

Magpadala ng API key bilang isang bearer token. Kailangang taglayin ng key ang pahintulot na reseller.manage; ang key na wala nito ay tatanggihan gamit ang 403, hindi 404.

Kung saan mapupunta ang id ng iyong organisasyon

Kinukuha ng endpoint na ito ang id ng iyong organisasyon sa mismong URL bilang org_id. Palitan ito sa path — walang header o query parameter na gagawa nito sa halip.

Ang id ng iyong organisasyon ay nasa screen ng mga API key sa iyong dashboard, sa tabi mismo ng key. Ito ang parehong id sa bawat tawag na gagawin mo.

Subukan ito

Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.

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> }'

Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API

Mga Detalye

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`.

Mga Parameter

Pangalan	Uri	Kailangan	Ano ito
`org_id (path)`	`Uuid`	Oo	The client organization whose balance moves. Must be one of yours.
`org_id (query)`	`Uuid`	Hindi	Which of YOUR organizations is acting. Not the client.

Katawan ng kahilingan

Pangalan	Uri	Kailangan	Ano ito
`delta_micros`	`integer`	Oo	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`	Oo	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.

Tugon

Pangalan	Uri	Kailangan	Ano ito
`pool_balance_micros`	`integer`	Oo	—
`client_balance_micros`	`integer`	Oo	—
`typical_calls`	`integer`	Oo	Roughly how many AI questions the client's new balance buys. An illustration — a long article costs many times a short question.

Mga error na maibabalik ng endpoint na ito

401 · 403 · 404 · 422 · 429