GET /v1/balance

Ten punkt końcowy tylko do odczytu sprawdza klucz API, ale nie wymaga dodatniego salda.

Wniosek

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

Odpowiedź

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

W przypadku poświadczeń indywidualnych saldo należy do użytkownika będącego właścicielem klucza. W przypadku poświadczeń biznesowych opłaty za interfejs API zawsze korzystają z portfela właściciela firmy. Udostępnione saldo firmy jest zwracane tylko wtedy, gdy podmiot zabezpieczeń ma widoczność salda na poziomie firmy (właściciel organizacji, administrator lub rola rozliczeniowa). Poświadczenia programisty/przeglądarki pracownika mogą wykonywać dozwolone żądania API, ale odbierać z nich kod HTTP 403 /v1/balance; ci użytkownicy widzą w panelu sterowania tylko dozwolone wykorzystanie grupy i limity. Klucz API usage I spend_limit pozostają odrębnymi wartościami.

Błąd uwierzytelnienia

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

Błąd pozwolenia biznesowego

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