GET /v1/balance

Ova krajnja točka samo za čitanje potvrđuje API ključ, ali ne zahtijeva pozitivan saldo.

Zahtjev

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

Odgovor

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

Za Individualne vjerodajnice, ravnoteža pripada korisniku koji posjeduje ključ. Za poslovne vjerodajnice, API naknade uvijek koriste novčanik vlasnika tvrtke. Zajednički saldo tvrtke vraća se samo kada glavni vjerodajnica ima vidljivost salda na razini tvrtke (vlasnik organizacije, administrator ili uloga naplate). Vjerodajnice programera/pregledatelja zaposlenika mogu izvršavati dopuštene API zahtjeve, ali primati HTTP 403 od /v1/balance; ti korisnici vide samo svoju dopuštenu grupnu upotrebu i ograničenja na upravljačkoj ploči. API-ključ usage i spend_limit ostaju odvojene vrijednosti.

Greška autentifikacije

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

Pogreška poslovne dozvole

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