Формат JSON

Для полегшення обробки результатів роботи kid3-cli, передбачено можливість отримання виведених даних у форматі JSON. Якщо запит буде виконано у форматі JSON, відповідь буде виведено також у форматі JSON. Компактний формат запиту також даватиме компактне представлення відповіді. Якщо у запиті міститиметься поле «id», він вважатиметься запитом JSON-RPC, і у відповіді міститиметься поле «jsonrpc» і значення «id» запиту. У форматі запиту використовуються ті самі команди, що і у стандартному інтерфейсі командного рядка, поле «method» має містити команду, а параметри (якщо такі є) задаються списком «params». Відповідь міститиме об'єкт «result», який також може бути порожнім, якщо відповідна команда kid3-cli не повернула жодного результату. Якщо станеться помилка, буде повернуто об'єкт «error» із полями «code» та «message», — типово для запитів 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"}