API Table
Infoscod ofrece una potente API de datos en tiempo real para descargar los datos correspondientes a los indicadores agrupados en un objeto (tabla, gráfico, mapa, dashboard,etc). Los resultados se entregan en milisegundos en formato JSON. Al utilizar la API Table, podrás obtener los datos de todas las series contenidas en el objeto de tu interés y utilizarlas en consecuencia.
Esta documentación describe en detalle las características de API Table, las opciones disponibles y las guías de integración en diferentes lenguajes de programación.
Consejo! Si quieres obtener el mejor resultado en el uso de las APIs consulta esta guía que te ayudará a comprender cómo funciona Infoscod.
Antes de empezar
Para obtener acceso a las APIs de Infoscod, es necesario disponer de una Clave de acceso API (API Access Key), que es la clave de autenticación única utilizada para obtener acceso a las APIs de Infoscod.
Todos los usuarios registrados en Infoscod disponen de una API Access Key. Consulta aquí cúal es tu Clave de acceso API o regístrate aquí para obtenerla.
Cómo usar API Table
El uso de API Table de Infoscod es simple. No hay más que añadir los Parámetros de consulta a la URL base de la API.
URL Base:
https://infoscod.es/apis/api_table.php
Agrega tu clave de acceso a la API y el código de la serie de datos que quieres obtener: Este es un ejemplo de llamada a la API que ilustra cómo autenticarse con la Clave de acceso API y obtener los datos de exportaciones por Comunidades Autónomas:
https://infoscod.es/apis/api_table.php ? access_key = YOUR_ACCESS_KEY &table = geo_101517486621 Run API Request
Respuesta API
API Table entrega datos en formato JSON. Este es el resultado que se obtiene en respuesta a la llamada a la API que se muestra en la sección anterior. Los datos corresponden a los que figuran en el mapa de España con los datos de exportaciones por Comunidades Autónomas.
[ { "serie": "cex_100100", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Andalucía", "data": { "2016": "26818164773.13", "2017": "30506661712.99", "2018": "32208736034.65", "2019": "31738158052.07", "2019 10": "2532159545.19", "2019 11": "2525965408.34", "2019 12": "2711986659.63", "2020 1": "2684979363.85", "2020 2": "2569110117.20" } }, { "serie": "cex_100200", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Aragón", "data": { "2016": "10893596446.51", "2017": "11800573476.24", "2018": "12655482155.54", "2019": "13472595381.49", "2019 10": "1221647680.82", "2019 11": "1270934037.61", "2019 12": "1064106314.54", "2020 1": "1210951888.97", "2020 2": "1295078762.16" } }, { "serie": "cex_100300", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Asturias", "data": { "2016": "3559049123.64", "2017": "4653679445.42", "2018": "4592179146.59", "2019": "4852647454.34", "2019 10": "409963257.24", "2019 11": "279049559.52", "2019 12": "521361333.81", "2020 1": "326660206.06", "2020 2": "376517163.24" } }, { "serie": "cex_100400", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Baleares", "data": { "2016": "1169611245.18", "2017": "1854817276.31", "2018": "1930282722.87", "2019": "1789749391.88", "2019 10": "190755934.96", "2019 11": "190381351.27", "2019 12": "118050073.91", "2020 1": "131616896.50", "2020 2": "133932783.88" } }, { "serie": "cex_100500", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Canarias", "data": { "2016": "2047552813.97", "2017": "2662815519.58", "2018": "2907204134.03", "2019": "2668028498.86", "2019 10": "182708026.56", "2019 11": "156157146.05", "2019 12": "352363000.87", "2020 1": "229288936.76", "2020 2": "214926529.30" } }, { "serie": "cex_100600", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Cantabria", "data": { "2016": "2345040634.09", "2017": "2419910728.89", "2018": "2583081168.39", "2019": "2613480786.32", "2019 10": "229352422.32", "2019 11": "199357453.81", "2019 12": "161814830.33", "2020 1": "241768846.89", "2020 2": "190837395.25" } }, { "serie": "cex_100700", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Castilla y León", "data": { "2016": "16240649925.5", "2017": "15512466189.9", "2018": "15267225799.09", "2019": "14562549850.04", "2019 10": "1480790178.67", "2019 11": "1382911628.86", "2019 12": "1021752885.09", "2020 1": "1137342491.11", "2020 2": "1223193241.86" } }, { "serie": "cex_100800", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Castilla - La Mancha", "data": { "2016": "6434261348.79", "2017": "7073152865.21", "2018": "7305843534.59", "2019": "7527345537.06", "2019 10": "737747815.19", "2019 11": "663796254.58", "2019 12": "593517868.71", "2020 1": "599767373.60", "2020 2": "643880948.08" } }, { "serie": "cex_100900", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Cataluña", "data": { "2016": "65166157735.14", "2017": "69646791710.98", "2018": "71174539542.68", "2019": "73853465043.21", "2019 10": "7056424828.96", "2019 11": "6237822608.34", "2019 12": "5407000602.35", "2020 1": "5873291079.42", "2020 2": "5972092317.27" } }, { "serie": "cex_101000", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Valencia", "data": { "2016": "28670572868.14", "2017": "29525249762.14", "2018": "30504415983.08", "2019": "31160193384.61", "2019 10": "2830081792.46", "2019 11": "2746970981.43", "2019 12": "2449454867.48", "2020 1": "2428830968.91", "2020 2": "2830856328.53" } }, { "serie": "cex_101100", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Extremadura", "data": { "2016": "1689199119.65", "2017": "1941913816.88", "2018": "2045917480.59", "2019": "2089364712.94", "2019 10": "208732826.64", "2019 11": "161785775.89", "2019 12": "130924093.30", "2020 1": "254905199.22", "2020 2": "144824535.62" } }, { "serie": "cex_101200", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Galicia", "data": { "2016": "19983852149.84", "2017": "21798363922.85", "2018": "22187964954.76", "2019": "22196663567.4", "2019 10": "2199745300.98", "2019 11": "2110868071.00", "2019 12": "1827681872.24", "2020 1": "1780593206.68", "2020 2": "1783603066.66" } }, { "serie": "cex_101300", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Madrid", "data": { "2016": "28761443210.78", "2017": "30000501143.13", "2018": "29956891830.83", "2019": "31178909455.66", "2019 10": "2918989851.91", "2019 11": "2770875134.10", "2019 12": "2459156925.83", "2020 1": "2303493563.77", "2020 2": "2578699142.53" } }, { "serie": "cex_101400", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Murcia", "data": { "2016": "9028991295.68", "2017": "10558813536.73", "2018": "10793749209.59", "2019": "10571459917.19", "2019 10": "879422838.83", "2019 11": "787053481.55", "2019 12": "844989097.05", "2020 1": "832840902.09", "2020 2": "863919357.22" } }, { "serie": "cex_101500", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "Navarra", "data": { "2016": "8445722402.6", "2017": "8105915330.6", "2018": "9144120564.61", "2019": "10147324971.25", "2019 10": "990609101.92", "2019 11": "884447694.21", "2019 12": "753787757.80", "2020 1": "788933580.81", "2020 2": "895883730.30" } }, { "serie": "cex_101600", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "País Vasco", "data": { "2016": "21625881200.03", "2017": "24108526082.73", "2018": "25740455892.66", "2019": "25388869214.84", "2019 10": "2362247417.07", "2019 11": "2339038856.65", "2019 12": "1818932776.46", "2020 1": "1967773180.45", "2020 2": "1900772284.97" } }, { "serie": "cex_101700", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "La Rioja", "data": { "2016": "1704516669.76", "2017": "1848064034.37", "2018": "1855244560.56", "2019": "1892178895.09", "2019 10": "186824687.45", "2019 11": "146639889.16", "2019 12": "129615310.34", "2020 1": "150920794.48", "2020 2": "165909264.68" } }, { "serie": "cex_100000", "titulo": "Exportaciones por CCAA", "titular": "", "leyenda": "España", "data": { "2016": "256346708656.54", "2017": "276142906499.75", "2018": "285127002996.73", "2019": "290089074085.68", "2019 10": "26861399684.53", "2019 11": "25061368327.80", "2019 12": "22566331550.02", "2020 1": "23142387842.04", "2020 2": "23992357129.17" } } ]
Conexión vía HTTPS
Las conexiones a las APIs de Infoscod vienen con soporte para cifrado SSL de 256 bits a través de conexión https.
Códigos de error
Cuando un recurso solicitado no está disponible o una llamada a la API falla por otro motivo, se devuelve un error JSON. Los errores siempre vienen con un código de error y una descripción.
Ejemplo de Error: Se devuelve el siguiente error cuando no se ha proporcionado una Clave de acceso API correcta.
"error": {
"code": 101,
"type": "invalid_access_key",
"info": "No se ha proporcionado una clave de acceso de API válida."
}
Otros errores:
| Código | Tipo | Info |
|---|---|---|
404 |
404_not_found |
El recurso solicitado no existe. |
101 |
missing_access_key |
No se ha proporcionado la clave de acceso de API. |
101 |
invalid_access_key |
No se ha proporcionado una clave de acceso de API válida. |
102 |
inactive_user |
La cuenta de usuario actual no está activa. |
103 |
invalid_api_data |
El recurso solicitado (serie de datos) no existe. |
103 |
no_data |
No existen registros con los parámetros especificados. |
104 |
usage_limit_reached |
Se ha alcanzado la cantidad máxima permitida de solicitudes de API mensuales. |
Parámetros de consulta
API Table permite configurar los parámetros de llamada para ajustar el resultado que se desea obtener en función de las necesidades de cada usuario
Parámetros de la solicitud:
| Parámetro | Descripción |
|---|---|
access_key |
[Requerido] Tu clave de acceso de API. |
table |
[Requerido] Código de la serie de datos de la que desea obtener los datos. Puedes localizar aquí las series de datos de tu interés. Utiliza  para configurar los parámetros de búsqueda. |
tbaux |
[Opcional] Código del indicador para el que se desea obtener los datos. Se usa cuando se quieren obtener datos de municipios, comarcas o provincias para aquellas series de datos disponibles a nivel de Galicia. |
Códigos de muestra
PHP (file_get_contents)
Búsqueda estándar: Se muestra a continuación un ejemplo para una carga de datos estándar
// establecer la serie de datos y la clave de acceso API $access_key = "YOUR_ACCESS_KEY"; $table = "bds_500000"; // Parámetros conexión $options = [ "ssl" => [ "verify_peer"=>false, "verify_peer_name"=>false, ] ]; $url_api = "https://infoscod.es/apis/api_table.php?access_key=$access_key&table=$table"; // Almacenar los datos $json = file_get_contents("$url_api", false, stream_context_create($options)); // Decodificar respuesta JSON $api_result = json_decode($json, true); // comprobar respuesta echo "$json";
PHP (cURL)
Búsqueda estándar: Se muestra a continuación un ejemplo para una carga de datos estándar utilizando PHP cURL.
// establecer la serie de datos y la clave de acceso API $access_key = "YOUR_ACCESS_KEY"; $table = "bds_500000"; // Inicializar cURL $ch = curl_init(); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);; curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Establecer la URL y otras opciones apropiadas $url_api = "https://infoscod.es/apis/api_table.php?access_key=$access_key&table=$table"; curl_setopt($ch, CURLOPT_URL, "$url_api"); // Almacenar los datos $json = curl_exec($ch); curl_close($ch); // Decodificar respuesta JSON $api_result = json_decode($json, true); // comprobar respuesta echo "$json";