Información sobre la API

Documentación

Este es un servicio web ligero el cual provee un camino de fácil acceso a los datos e información mostrados en esta web.

Los datos de esta aplicación hacen uso del servicio web de la Agencia Estatal de Meteorología - AEMET. Gobierno de España, que autoriza el uso de la información y reproducción citando a © AEMET como autora de la misma.

Se ha desarrollado una interface REST con la que puedes obtener los datos elaborados por © AEMET en formato JSON.

API versión 2

Objetivo

El objetivo de esta versión es mostrar la misma información mostrada en esta web respecto al grupo de páginas con información meteorológica. La información es servida en formato JSON.

Estes conjunto de datos pueden ser usados para crear aplicaciones web SPA . Especialmente indicado para aquellas personas que se están formando en tecnologías JavaScript y su uso en el front-end actual. Puede hacer uso de librerías o frameworks como React, Vue o Angular con este fin.

Si haces uso de esta API con estos fines, no es obligatorio, pero si es de agradecer nombrarla y/o referenciarla mediante algún link.

A continuación podrás encontrar el listado de comandos:

Ayudanos

Si encuentras un error tanto en la documentación como en los datos meteorológicos, geográficos, códigos de respuesta o de cualquier otro carácter al usar la API, te agradecemos que nos avises contactando con nosotros.

Para nosotros es importante que la información ofrecida sea útil y se encuentre actualizada.

¡Muchas gracias! :-)

Información nacional

https://www.el-tiempo.net/api/json/v2/home

Lista de provincias

https://www.el-tiempo.net/api/json/v2/provincias

Lista de municipios Eliminado

https://www.el-tiempo.net/api/json/v2/municipios

Información geográfica y meteorológica de una provincia

Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.

https://www.el-tiempo.net/api/json/v2/provincias/[CODPROV]

Un ejemplo:

https://www.el-tiempo.net/api/json/v2/provincias/01

Lista de municipios de una provincia

Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.

https://www.el-tiempo.net/api/json/v2/provincias/[CODPROV]/municipios

Un ejemplo:

https://www.el-tiempo.net/api/json/v2/provincias/01/municipios

Información geográfica y meteorológica de un municipio

El [ID] son los primeros cinco dígitos del dato CODIGOINE que podrás encontrar, por ejemplo, en el comando anterior. Debes sustituir el [ID] por los cincos primeros dígitos del CODIGOINE.

Los dos primeros dígitos del CODIGOINE son los dos dígitos que representan CODPROV (id o código de provincia). Deben coincidir para ejecutar el comando con éxito.

https://www.el-tiempo.net/api/json/v2/provincias/[CODPROV]/municipios/[ID]

Un ejemplo de la construcción de este comando:

https://www.el-tiempo.net/api/json/v2/provincias/01/municipios/01001

API versión 1 Deprecated

Aviso

Esta versión de la API está en estado deprecada y será completamente desactivada el 31 de diciembre de 2023. Por favor, si estás haciendo usa de ella, comienza la migración a la versión 2 de la API, más reciente que esta.

Objetivo

El objetivo de esta versión es tener un conjunto de datos en formato JSON con los que poder interactuar mediante otros programas o interfaces y poder utilizar la información para diferentes fines.

Estes conjunto de datos también pueden ser usados para crear aplicaciones web SPA . Especialmente indicado para aquellas personas que se están formando en tecnologías JavaScript y su uso en el front-end actual.

Si haces uso de esta API con estos fines, no es obligatorio, pero si es de agradecer nombrarla y/o referenciarla mediante algún link.

A continuación podrás encontrar el listado de comandos:

Lista de provincias

https://www.el-tiempo.net/api/json/v1/provincias

Lista de municipios Eliminado

https://www.el-tiempo.net/api/json/v1/municipios

Información de una provincia

Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.

https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]

Un ejemplo:

https://www.el-tiempo.net/api/json/v1/provincias/01

Lista de municipios de una provincia

Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.

https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]/municipios

Un ejemplo:

https://www.el-tiempo.net/api/json/v1/provincias/01/municipios

Información de un municipio

El [ID] son los primeros cinco dígitos del dato CODIGOINE que podrás encontrar, por ejemplo, en el comando anterior. Debes sustituir el [ID] por los cincos primeros dígitos del CODIGOINE.

Los dos primeros dígitos del CODIGOINE son los dos dígitos que representan CODPROV (id o código de provincia). Deben coincidir para ejecutar el comando con éxito.

https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]/municipios/[ID]

Un ejemplo de la construcción de este comando:

https://www.el-tiempo.net/api/json/v1/provincias/01/municipios/01001

Información del tiempo de un municipio

Al igual que en el comando anterior, el [ID] son los cinco primeros dígitos del dato CODIGOINE que podrás encontrar, por ejemplo, en el comando anterior. Debes sustituir el [ID] por los cincos primeros dígitos del CODIGOINE.

Los dos primeros dígitos del CODIGOINE son los dos dígitos que representan CODPROV (id o código de provincia). Deben coincidir para ejecutar el comando con éxito.

https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]/municipios/[ID]/weather

Un ejemplo:

https://www.el-tiempo.net/api/json/v1/provincias/01/municipios/01001/weather

Recomendaciones sobre la API

La API de este sitio siempre ha existido, e intentaremos que siga siendo así por mucho tiempo, completamente abierta y con un objetivo de uso puramente pedagógico.

Ya sea para crear experimentos y/o usada en docencia para la realización de ejercicios en el campo de la tecnología y desarrollo de aplicaciones y web.

Es por eso que el uso de esta API para un entorno de producción no sea la más adecuada si tienes que hacer un uso intensivo de la información meteorológica. Es muy probable que este pequeño proyecto no sea capaz de asumir un número elevado de peticiones. Por este motivo es muy recomendable que si haces uso de la API aquí expuesta y tu proyecto está creciendo, migres a otra API que tenga un mayor soporte para un gran número de llamadas.

En cualquier caso no dejes de probar, usar y testear la API de elTiempo.net y su documentación. Y si te gusta este proyecto, no dejes de mencionarlo en tus blogs, artículos y/o redes.