GET /v1/balance

Tento koncový bod iba na čítanie overuje kľúč API, ale nevyžaduje kladný zostatok.

Žiadosť

curl https://api.model-gate.com/v1/balance \
  -H "Authorization: Bearer mg_live_..."

odpoveď

{
  "object": "balance",
  "currency": "USD",
  "balance": "12.3400000000"
}

V prípade individuálnych poverení patrí zostatok používateľovi, ktorý vlastní kľúč. V prípade obchodných poverení sa poplatky za rozhranie API vždy používajú v peňaženke vlastníka spoločnosti. Zdieľaný zostatok spoločnosti sa vráti iba vtedy, keď má splnomocnenec viditeľnosť zostatku na úrovni spoločnosti (vlastník organizácie, správca alebo rola fakturácie). Poverenia vývojára/prehliadača zamestnanca môžu vykonávať povolené požiadavky API, ale prijímať HTTP 403 od /v1/balance; títo používatelia vidia na ovládacom paneli iba povolené skupiny a limity. API kľúč usage a spend_limit zostávajú samostatné hodnoty.

Chyba overenia

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "invalid API key"
  }
}

Chyba obchodného povolenia

{
  "error": {
    "type": "permission_error",
    "code": "balance_not_permitted",
    "message": "Company balance is not available for this credential principal."
  }
}