Fouten

Via REST is elke fout {"code":"…"} en niets anders: een vaste code, nooit een zin, zodat u ze voor uw eigen gebruikers kunt vertalen. De MCP-server meldt een opzoeking zonder resultaat daarentegen als gewoon resultaat; alleen 401 en 429 bereiken een MCP-client als status.

Code	Status	Betekent	Wat te doen
`missing_token`	401	Geen `Authorization: Bearer`-header	Stuur uw API-sleutel mee
`invalid_token`	401	Onbekende, misvormde of ingetrokken sleutel	Controleer de sleutel, of maak een nieuwe aan
`query_required`	400	`GET /v1/companies` zonder `q`	Voeg een zoekterm toe
`insufficient_credits`	402	Geen plan, of het saldo dekt dit antwoord niet	Kies een plan of koop credits bij op app.otbstudio.ai
`not_found`	404	Geen enkele onderneming heeft dit ondernemingsnummer, of geen enkele route heeft dit pad	Controleer het nummer of het pad
`method_not_allowed`	405	Het pad bestaat, de methode niet	Elke dataroute is een `GET`
`rate_limited`	429	Boven de snelheidslimiet van de organisatie, of te veel aanroepen tegelijk	Probeer opnieuw na `Retry-After` seconden
`internal`	500	Een fout aan onze kant	Probeer opnieuw; elke dataroute is een veilige, idempotente leesbewerking
`busy`	503	De data konden niet binnen 15 seconden gelezen worden	Probeer opnieuw na `Retry-After` seconden

Bij een 402 zeggen X-Credits-Cost en X-Credits-Remaining hoeveel het saldo tekortschoot. Werd de aanroep geweigerd voor hij uitgevoerd werd (geen plan, of een saldo van nul), dan is X-Credits-Cost 0, omdat de prijs dan nog niet bekend is. De accountroutes die het dashboard gebruikt, hebben nog andere codes. Die maken geen deel uit van een data-integratie. Vastgelopen? Mail engineering@otbstudio.ai.

Aan de slag

Verbinden

Data

In productie