Documentación de la API

Esta sección proporciona una visión general del funcionamiento de la API de nuestro portal Open Data. Aquí encontrarás ejemplos de uso, información sobre la autenticación y detalles sobre cómo realizar consultas.

Ejemplo de Uso

Para realizar una consulta a la API y acceder a los datos del dataset "energia_cat", puedes usar el siguiente enlace como ejemplo:

https://opendata.iter.es/api/energia_cat

Para realizar la misma consulta a la API pero usando tu token personal:

curl "https://opendata.iter.es/api/energia_cat" -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoib3BlbmRhdGFfZ2VuZXJhbCJ9.ZLAgqz_gxYpvH9_vVjQCMN57zSfR3t1vmhQ4SSm1MtI"

Swagger UI

Para explorar y probar los diferentes endpoints de nuestra API, ponemos a tu disposición una interfaz Swagger. Puedes acceder a ella aquí para probar las funcionalidades de la API de manera interactiva.

Consultas complejas

La API permite realizar consultas complejas y filtrar los datos. Para más detalles sobre cómo estructurar estas consultas, por favor revisa la documentación de PostgREST en este enlace.

Ejemplo de consulta compleja, devolver registros con fecha igual o posterior a 2023-01-01 del dataset energia_cat:

https://opendata.iter.es:443/api/energia_cat?Periodo%20inicial=gte.2023-01-01

Uso del Token en la API

Para acceder a partes específicas de la API o hacer un uso intensivo de la misma se requiere un token de autenticación. Puedes obtener tu token contactando con el equipo de soporte en robotica@iter.es