With release 2108 we introduce RPC API. JSON-RPC is a stateless, light-weight remote procedure call (RPC) protocol. Primarily this specification defines several data structures and the rules around their processing. It is transport agnostic in that the concepts can be used within the same process, over sockets, over http, or in many various message passing environments. It uses JSON (RFC 4627) as data format.
To make a JSON-RPC request, send an HTTP POST request to the
[AIDBOX_BASE_URL]/rpcendpoint with a
Content-Type: application/jsonheader. The JSON request data should contain 2 fields:
method: <string>, a string containing the method to be invoked
params: <array>, a JSON object of parameters
Example using curl:
curl "$AIDBOX_BASE_URL/rpc" \
-H "Content-Type: application/json" \
The response output is a JSON object with one of the following fields:
result: <array|number|object|string>, requested data or success confirmation
Requests can be sent in batches by sending an array of JSON-RPC request objects as the data for a single POST.