JSON-format

För att göra det enklare att tolka resultat från kid3-cli är det möjligt att få utmatningen på JSON-format. När begäran använder JSON-format blir också svaret JSON. Ett kompakt format på begäran ger också kompakt representation av svaret. Om begäran innehåller ett "id"-fält antas det bara en JSON-RPC-begäran och svaret innehåller fältet "jsonrpc" och "id" för begäran. Formatet på en begäran använder samma kommando som det vanliga kommandoradsgränssnittet, fältet "method" innehåller kommandot och parametrarna (om det finns några) anges i listan "params". Svaret innehåller objektet "result", som också kan vara null om motsvarande kid3-cli kommando inte returnerar ett resultat. I händelse av fel, returneras objektet "error" med fälten "code" och "message" som används av JSON-RPC.

kid3-cli> {"method":"set","params":["artist","An Artist"]}
{"result":null}
kid3-cli> {"method":"get","params":["artist",2]}
{"result":"An Artist"}
kid3-cli> {"method": "get", "params": ["artist"]}
{
    "result": "An Artist"
}

kid3-cli> {"jsonrpc":"2.0","id":"123","method":"get","params":["artist"]}
{"id":"123","jsonrpc":"2.0","result":"An Artist"}