GET /v1/balance

Dette skrivebeskyttede slutpunkt validerer API-nøglen, men kræver ikke en positiv saldo.

Anmodning

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

Svar

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

For individuelle legitimationsoplysninger tilhører saldoen den bruger, der ejer nøglen. For virksomhedslegitimationsoplysninger bruger API-afgifter altid virksomhedens ejers tegnebog. Den delte virksomhedssaldo returneres kun, når legitimationsprincipperen har saldosynlighed på virksomhedsniveau (organisationsejer, administrator eller faktureringsrolle). Medarbejderudvikler/seer-legitimationsoplysninger kan udføre tilladte API-anmodninger, men modtage HTTP 403 fra /v1/balance; disse brugere ser kun deres tilladte gruppebrug og begrænsninger i kontrolpanelet. API-nøgle usage og spend_limit forblive separate værdier.

Godkendelsesfejl

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

Virksomhedstilladelsesfejl

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