GET /v1/balance

Šis tikai lasāmais galapunkts apstiprina API atslēgu, taču tam nav nepieciešams pozitīvs atlikums.

Pieprasīt

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

Atbilde

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

Individuālajiem akreditācijas datiem atlikums pieder lietotājam, kuram pieder atslēga. Uzņēmuma akreditācijas datiem API izmaksas vienmēr izmanto uzņēmuma īpašnieka maku. Dalītais uzņēmuma atlikums tiek atgriezts tikai tad, ja akreditācijas pilnvarotajam ir uzņēmuma līmeņa bilances redzamība (organizācijas īpašnieks, administrators vai norēķinu loma). Darbinieku izstrādātāja/skatītāja akreditācijas dati var izpildīt atļautos API pieprasījumus, bet saņemt HTTP 403 no /v1/balance; šie lietotāji vadības panelī redz tikai viņu atļauto grupu lietojumu un ierobežojumus. API atslēga usage un spend_limit paliek atsevišķas vērtības.

Autentifikācijas kļūda

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

Uzņēmuma atļaujas kļūda

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