GET /v1/balance

Ta končna točka samo za branje potrdi ključ API, vendar ne zahteva pozitivnega stanja.

Zahteva

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

Odziv

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

Pri posameznih poverilnicah stanje pripada uporabniku, ki je lastnik ključa. Za poslovne poverilnice API-ji vedno uporabljajo denarnico lastnika podjetja. Stanje podjetja v skupni rabi se vrne le, če ima glavni poverilnice vidnost stanja na ravni podjetja (lastnik organizacije, skrbnik ali vloga zaračunavanja). Poverilnice razvijalca/gledalca zaposlenih lahko izvajajo dovoljene zahteve API-ja, vendar prejmejo HTTP 403 od /v1/balance; ti uporabniki na nadzorni plošči vidijo samo svojo dovoljeno skupinsko uporabo in omejitve. API-ključ usage in spend_limit ostanejo ločene vrednosti.

Napaka pri preverjanju pristnosti

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

Napaka poslovnega dovoljenja

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