Servicio web: Áreas formativas

Modificado el Vie, 18 Oct a 2:50 P. M.

Introducción

Este servicio web sirve para conocer las áreas formativas publicadas en tu catálogo de formación.

De esta forma puedes llevar esta información a otros sistemas como por ejemplo una tienda WooCommerce.

Proceso de consumo

Se utiliza el protocolo de comunicación HTTP.

Los pasos serían:

Autenticarte
1. Se requiere autenticación HTTP mediante los datos de acceso de un usuario de Gesforma con perfil de coordinador (loginname y contraseña).
2. Para aumentar la seguridad en el consumo del servicio aconsejamos activar el token API de tu cuenta (más info)
Consumir el servicio (debes solicitarnos que te proporcionemos la URL)
Solicitud: se envía en formato JSON
Respuesta: se recibe una respuesta en formato JSON.

Solicitud

Sin parámetros

Respuesta

Usa notación JSON con la siguiente estructura.

Campo	Descripción	Tipo de dato	VALOR ESPERADO
success	Indica el resultado de la operación de autenticación	Entero	1 (si éxito), 0 (si error)
num_areas	Número de áreas en el catálogo	Entero	Número entero positivo
areas	Conjunto de áreas del catálogo	Array de objetos	Array de objetos, cada uno con los siguientes subcampos: - id: Entero positivo - codigo: Texto (máx. 25 caracteres) - nombre: Texto (máx. 150 caracteres) - publica: 1 (si es pública), O (si no es pública) - imagen: Texto (máx. 255 caracteres) URL de la Imagen

Ejemplo

{
"success":1,
"num_areas": 42,
"areas": "[{\"id\":\"1\", \"codigo\": null, \"nombre\": \"Comercial y Marketing\", \"publica\":1" \"imagen\":\"descarga_imagen_area.php?id=1\"},{\"'id)":\"2\",\"codigo\":null,\"nombre\":|"Dise\\u00f1o\",\"publica\":\"1\",\"imagen\":\"descarga_imagen_area.php?id=2\"}
]