Tutorial de JavaScript

Cómo consumir una API con fetch en JavaScript

Una API es un servicio en internet que te da datos: productos, clima, Pokémon. Con fetch tu programa le pide los datos a una URL, espera la respuesta y la convierte con .json() en objetos que ya sabes usar. Aquí verás cómo se escribe con una API real y un ejemplo resuelto.

fetch: pedirle datos a una API

Una API es una dirección de internet que, en lugar de una página, responde con DATOS (en JSON). Las tiendas, los mapas, el clima, las redes sociales… todas las apps modernas toman sus datos de APIs.

fetch(dirección) le pide datos a esa dirección y devuelve una promesa con la respuesta. La respuesta trae el estado y el texto; respuesta.json() (otra promesa) convierte ese texto JSON en objetos de JavaScript.

En la vista previa tu código se conecta a la API REAL, como en un sitio de verdad: ejecútalo y mira qué llega. Al revisar tu respuesta usamos una copia guardada de esos datos, para que la calificación no dependa de tu internet.

Cómo se escribe

const respuesta = await fetch("https://api.com/algo") const datos = await respuesta.json()

fetch(dirección)
pide los datos a la API (devuelve una promesa)
await
espera a que llegue la respuesta
respuesta.json()
convierte el texto JSON en objetos (también se espera con await)
datos
ya son objetos normales: datos.title, datos.price

Ejemplo resuelto

index.html

<h1 id="nombre">Cargando…</h1>
<p id="datos"></p>
<script src="script.js" defer></script>

script.js

async function mostrarPokemon() {
  const respuesta = await fetch("https://pokeapi.co/api/v2/pokemon/pikachu")
  const pokemon = await respuesta.json()
  console.log(pokemon)

  document.querySelector("#nombre").textContent = pokemon.name
  document.querySelector("#datos").textContent = `Peso: ${pokemon.weight / 10} kg`
}

mostrarPokemon()

Así se ve

PokéAPI (pokeapi.co), otra API pública: se pide a Pikachu y se muestran su nombre y su peso en la página.

  • Las dos líneas llevan await: fetch tarda (viaja por internet) y .json() también es una promesa. Sin el segundo await, producto sería una promesa y producto.title daría undefined.
  • Antes de mostrar algo, haz console.log(producto) para ver TODO lo que manda la API y elegir qué datos usar.
  • Cada API documenta sus direcciones. En Fake Store: /products (todos), /products/1 (uno), /products/categories (categorías).

Preguntas frecuentes

¿Qué es una API?

Un servicio que responde datos en formato JSON cuando le pides una URL. Por ejemplo, Fake Store API devuelve productos de una tienda de prueba.

¿Por qué necesito await?

fetch tarda: la respuesta llega después. await espera a que llegue antes de seguir con la siguiente línea.

¿Qué hago si la API falla?

Envuelve el fetch en try/catch y revisa respuesta.ok para mostrar un mensaje en lugar de una página en blanco.