JSON se utiliza cada vez más en la web como sintaxis para usos concretos.
JSON-RPC: JSON Remote Procedure Call
En informática, los procedimientos remotos son una característica de los sistemas distribuidos. En un programa está distribuido entre varios ordenadores, los procedimientos remotos permiten que una parte del programa ejecute otra parte del programa situada en otro ordenador de forma transparente, es decir, sin que el programador se tenga que preocupar de dónde está situada cada parte.
En general, cuando que un programa solicita información a otro programa situado en otro ordenador podemos decir que se trata de una llamada a un procedimiento remoto, aunque los dos programas sean completamente independientes.
JSON-RPC es un formato para el intercambio de información entre dos programas. Utiliza la notación JSON y define una estructura y unos campos mínimos útiles para dar formato tanto a la petición como a la respuesta.
Existen dos versiones de JSON-RPC, pero se recomienda utilizar la segunda versión:
Una llamada RPC tiene que seguir la sintaxis de JSON y contener los siguientes campos:
- jsonrpc: una cadena que indica la versión ("2.0")
- method: una cadena que indica el método invocado.
- params: (optativo) una matriz o una lista de valores
- id: un número o cadena establecido por el cliente
Si una llamada no incluye identificador id, se considera que es una notificación y no requiere respuesta, ni siquiera en caso de error.
La respuesta RPC tiene que seguir también la sintaxis de JSON y contener los siguientes campos:
- jsonrpc: una cadena que indica la versión ("2.0")
- uno de estos dos campos:
- result: (optativo) el resultado de la consulta, en forma de valor, matriz o lista.
- error: (optativo) una matriz o una lista de errores, con la estructura siguiente:
- code: código de error (número entero)
- message: descripción breve del error
- data: (optativo) matriz o lista de valores con información adicional sobre el error
- id: el número o cadena establecido por el cliente
Una llamada JSON-RPC puede contener varias peticiones en forma de matriz y se debe contestar con una matriz de respuestas (salvo que todas las llamadas sean notificaciones, en cuyo caso no habría respuesta).
Ejemplos de llamada y respuesta:
- Petición:
{
"jsonrpc": "2.0",
"method": "suma",
"params": [3, 4, 5],
"id": 181203
}
- Respuesta:
{
"jsonrpc": "2.0",
"result": 12,
"id": 181203
}
JSON-LD: JSON Linked Data
JSON-LD es un formato desarrollado por el W3C y que utiliza la sintaxis de JSON para representar información referida a un elemento (un objeto, una persona, etc.). La información que se ofrece en un bloque de datos JSON-LD sobre un elemento consiste en una lista de características de ese elemento.
- Las características del elemento se enumeran en forma de clave : valor.
- las características del elemento se pueden agrupar en unos bloques predefinidos: @context, @id, @value, @language, @type, @container, @list, @set, @reverse, @index, @base, @vocab, @graph.
Grupo de trabajo JSON-LD en el W3C: Homepage - Charter: 2018-2020
Recomendaciones publicadas:
JSON (JavaScript Object Notation) es un formato de texto pensado para el intercambio de datos. Su sintaxis está basada originalmente en la sintaxis de JavaScript, pero realmente es independiente de cualquier lenguaje de programación.
