GET /v1/balance

Ова крајња тачка само за читање потврђује АПИ кључ, али не захтева позитиван баланс.

Захтев

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

Одговор

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

За појединачне акредитиве, стање припада кориснику који поседује кључ. За пословне акредитиве, накнаде за АПИ увек користе новчаник власника компаније. Заједничко стање предузећа се враћа само када принципал акредитива има видљивост стања на нивоу компаније (власник организације, администратор или улога наплате). Акредитиви програмера/гледача запослених могу да извршавају дозвољене АПИ захтеве, али примају ХТТП 403 од /v1/balance; ти корисници виде само своје дозвољено групно коришћење и ограничења на контролној табли. АПИ-кључ usage и spend_limit остају засебне вредности.

Грешка при аутентификацији

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

Грешка у пословној дозволи

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