Erklärung des Begriffs: JSON-RPC

Zur Stichwortliste unseres Lexikons

Was ist JSON-RPC ?

JSON-RPC ist ein schlankes Protokoll für Remote Procedure Calls mit JSON als Datenformat: Ein Client ruft über eine Nachricht eine Funktion auf einem Server auf und erhält bei Bedarf eine Antwort. Die aktuelle Spezifikation ist JSON-RPC 2.0.

JSON-RPC definiert nur Nachrichtenformat und Bedeutung der Felder, nicht den Transportweg. Es kann über HTTP, WebSocket, Standard-Ein-/Ausgabe (STDIO) oder andere bidirektionale Kanäle laufen.

Im Unterschied zu REST steht nicht eine Ressource wie /flights/4711 im Vordergrund, sondern ein Methodenaufruf wie getFlightDetails.

Moderne KI-Protokolle wie MCP, ACP und A2A basieren auf JSON-RPC 2.0 als Protokollgrundlage, ergänzen es aber um eigene Methoden und Regeln, etwa initialize, tools/list und tools/call.

Beispiel JSON-RPC

Eine JSON-RPC-Anfrage enthält:

{
"jsonrpc": "2.0",
"method": "getFlightDetails",
"params": {
"flightNo": 4711
},
"id": 42
}

jsonrpc: Muss den Wert "2.0" haben.
Method: Name der aufzurufenden Methode.
Params: Optionale Argumente, entweder als Objekt (benannte Parameter) oder Array (positionale Parameter).
Id: Kennung zur Zuordnung von Antwort und Anfrage.

Die zugehörige Erfolgsmeldung lautet beispielsweise:

{
"jsonrpc": "2.0",
"result": {
"flightNo": 4711,
"destination": "Berlin"
},
"id": 42
}

Bei einem Fehler liefert der Server statt result ein error-Objekt:

{
"jsonrpc": "2.0",
"error": {
"code": -32601,
"message": "Method not found"
},
"id": 42
}

Standardisierte Fehlercodes sind unter anderem:

Code Bedeutung
-32700 : JSON konnte nicht geparst werden
-32600 : Ungültige Anfrage
-32601: Methode existiert nicht
-32602 : Ungültige Parameter
-32603 : Interner Serverfehler

Eine Notification ist ein Methodenaufruf ohne id. Der Server darf dafür keine Antwort senden:

{
"jsonrpc": "2.0",
"method": "progress",
"params": { "percent": 50 }
}

Beratung & Support

Schulungen

Anfrage für eine individuelle Schulung zum Thema JSON-RPC Gesamter Schulungsthemenkatalog

Fachbücher

Alle unsere aktuellen Fachbücher E-Book-Abo für ab 99 Euro im Jahr