Spec

pyRPC protocol specification.

pyRPC uses JSON-RPC 2.0 over HTTP. See Protocol Design for a detailed explanation.

Endpoints

MethodPathDescription
POST/rpcDispatch an RPC method call
GET/rpcIntrospection, returns schema of all registered procedures

Error Codes

CodeMessageDescription
-32600Invalid RequestMalformed JSON-RPC envelope
-32601Method not foundProcedure name not registered in router
-32602Invalid paramsType validation failure on arguments
-32603Internal errorUnhandled exception during procedure execution

Transport

  • HTTP/1.1 or HTTP/2
  • Content-Type: application/json
  • The standalone ASGI transport adds CORS headers (all origins)
  • Framework adapters defer CORS to the host application