Road User Tools Agenten- & API-Plattform

Grenzwerte und Validierung

Road User Tools validiert Anfragen vor der Berechnung und gibt konsistente, maschinenlesbare Fehler zurück, wenn eine Anfrage nicht abgeschlossen werden kann.

Limits anfordern

JSON-Anforderungskörper sind beschränkt auf16 KiB. Eingaben werden vor der Berechnung validiert, einschließlich unterstützter Einheiten, endlicher Zahlenwerte, unerwarteter Felder und Wertebereiche wie nicht negativer Entfernungen.

Öffentlicher API-Index

GET /api/v1ist ohne Authentifizierung verfügbar und stellt grundlegende API-Informationen bereit. Werkzeugerkennung, Berechnungen und MCP-Anfragen erfordern einen gültigen API-Schlüssel.

Fehler

REST-Fehler geben neben einer für Menschen lesbaren Nachricht einen stabilen maschinenlesbaren Code zurück. MCP-Transportfehler verwenden die JSON-RPC-Formatierung und enthalten den Road User Tools-Fehlercodeerror.data.code.

REST-Fehlerjson

{
  "ok": false,
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again shortly."
  }
}

400invalid_requestDer Anfragetext oder eines seiner Felder ist ungültig.

401unauthorizedDer Schlüssel API fehlt, ist fehlerhaft, widerrufen oder wird nicht erkannt.

403forbiddenDer Schlüssel API verfügt nicht über den erforderlichen Bereich.

404not_foundDer angeforderte Endpunkt existiert nicht.

413payload_too_largeDer Anforderungstext überschreitet 16 KiB.

415unsupported_media_typeDer Endpunkt erfordert eine application/json Anfrage.

429rate_limitedDas Anforderungslimit wurde erreicht. Versuchen Sie es in Kürze noch einmal.

500internal_errorDer Dienst konnte die Anfrage nicht abschließen.