API-Eustat

Eustaten APIaren dokumentazioa eta tutorialak

1. Eustaten APIaren gida teknikoa

📘 Eustaten APIaren gida teknikoak Eustaten APIari buruzko oinarrizko informazioa ematen du: sarbide puntuak (endpoint-ak), eskaeren egitura (GET eta POST), hizkuntza parametroak eta erantzun formatuak (JSON, CSV, XLSX). APIaren funtzionamendua ulertzeko lehen urratsa da.

2. Swagger bisorea (OpenAPI estandarra)

APIak modu bisual eta intuitiboan esploratzeko, Swagger bisoreak erabil daitezke. Nabigatzailetik bertatik APIen sarrera puntu guztiak (endpoint-ak) eta parametro desberdinak probatu daitezke, eskaerak bidali eta, erantzuna zuzena bada, datuak json formatuan deskargatu.

🔹 Eustaten API nagusiaren Swagger bisorea Eustateko banku-datuko datu estatistiko orokorretarako APIaren endpoint eta kontsulta guztiak biltzen ditu.

🔹 Eustateko Garapen Jasangarrirako Helburuen (GJH) adierazleen datu-zerbitzua 2030 Agendako Garapen Jasangarrirako adierazleak kontsultatzeko API espezifikoa dokumentatzen du.

3. Erabilera adibideak

Eustaten APIa nola erabili erakusteko, hiru tutorial praktiko prestatu ditugu. R, Python eta JavaScript erabiliz, APIari kontsultak nola egin eta datuak nola prozesatu azaltzen dute, adibideen bidez.

  1. 📘 R tutoriala
    RMarkdown formatuan dago, RStudion ikusteko.
    Jupyter Notebook formatuan ere eskuragarri dago: Githuben ikusi edo ireki Colab-en Ireki Colab-en (Google kontu bat beharko duzu)

  2. 📙 Python tutoriala
    Jupyter Notebook formatuan dago. Githuben ikusi edo ireki Colab-en Ireki Colab-en (Google kontu bat beharko duzu)

  3. 📊 JavaScript-en adibidea
    Adibide honek API dei baten bidez Highcharts grafiko sinple bat nola sortzen den erakusten du


Documentación y tutoriales de la API de Eustat

1. Guía técnica de la API de Eustat

En la 📘 Guía técnica de la API de Eustat se proporciona información básica sobre el API de Eustat: puntos de acceso (endpoints), estructura de solicitudes (GET y POST), parámetros de lenguaje y formatos de respuesta (JSON, CSV, XLSX). Es el primer paso para entender cómo se utiliza la API.

2. Visor Swagger (estándar OpenAPI)

Para la exploración visual e intuitiva de las APIs se pueden utilizar visores Swagger. Desde el navegador se pueden probar todos los puntos de entrada (endpoints) y parámetros, enviar solicitudes y, si la respuesta es correcta, descargar los datos en formato json.

🔹 Visor Swagger de la API general de Eustat Incluye todos los endpoints y consultas para el acceso a los datos estadísticos del banco de datos de Eustat

🔹 Servicio de datos de Indicadores de Desarrollo Sostenible (ODS) de Eustat Documenta la API específica para la consulta de indicadores de Desarrollo Sostenible de la Agenda 2030

3. Ejemplos de uso

Este repositorio incluye tres tutoriales prácticos que te guiarán en el uso de la API de Eustat. Están disponibles en R, Python y JavaScript, e incluyen ejemplos de consulta y tratamiento de datos.

  1. 📘 Tutorial en R
    En formato RMarkdown, para ver en RStudio.
    También hay una versión en formato Jupyter Notebook: Ver en Github o abrir en Colab Abrir en Colab (necesitarás una cuenta de Google)

  2. 📙 Tutorial en Python
    Disponible en formato Jupyter Notebook. Ver en Github o abrir en Colab Abrir en Colab (necesitarás una cuenta de Google)

  3. 📊 Ejemplo en JavaScript
    Ejemplo de código en JavaScript para realizar una llamada a la API y generar un gráfico simple con Highcharts