Entiende qué es una API.

7 min · Sin experiencia previa · Tecnología

Una lección de 7 minutos: qué es una API, el contrato entre programas, sus 4 piezas con un ejemplo real y una prueba de 3 preguntas.

Qué es una API y cómo leer una petición, un endpoint y una respuesta en formato JSON.

El caso

Tu app del clima no mide la temperatura. Se la pide a alguien.

En 7 minutos sabrás qué es una API, cómo viaja una petición y su respuesta, y leerás un intercambio real como quien lee una conversación.

Lo que aprenderás

  • Explicar qué es una API con tus palabras
  • Localizar petición, endpoint, respuesta y formato en un ejemplo
  • Leer un intercambio GET con JSON sin programar

El contrato entre programas

Una API es un acuerdo: un programa pide algo de una forma concreta y otro responde de una forma concreta. Si entiendes el acuerdo, entiendes la API.

  1. Petición

    Lo que un programa pide: a dónde y qué quiere.

  2. Endpoint

    La dirección exacta que atiende cada solicitud.

  3. Respuesta

    Lo que devuelve el otro lado, con un estado.

  4. Formato

    El idioma pactado de la respuesta, normalmente JSON.

Preguntas frecuentes

¿Qué es una API?

Un acuerdo para que dos programas se comuniquen: uno pide de una forma concreta y el otro responde de una forma concreta.

¿Necesito saber programar?

No: esta lección enseña a leer intercambios, no a escribir código.

Ponte a prueba: Prueba relámpago: ¿hablas API?

¿Qué es una API?

Respuesta correcta: Un contrato para que dos programas se pidan y devuelvan cosas.

La API no es la app ni los datos: es el acuerdo que permite pedirlos y recibirlos de forma predecible.

Tu app del clima muestra 21°. ¿Qué pasó por detrás?

Respuesta correcta: La app pidió el dato a una API y mostró su respuesta.

La app no mide nada: pide a un endpoint y presenta la respuesta. Ella es el cliente, no el meteorólogo.

Ves GET /tiempo → {temp: 21}. ¿Qué significa?

Respuesta correcta: Alguien pide el tiempo y recibe 21 en el formato acordado.

GET es el verbo (dame), /tiempo la dirección y {temp: 21} la respuesta pactada. Contrato cumplido.

La regla de bolsillo — Una API es un contrato: quién pide, a qué dirección, qué devuelve y en qué formato. Si localizas esas cuatro cosas, la entiendes.

Lo que te llevas

Explicar qué es una API y leer una petición y su respuesta.

Sigue aprendiendo

Abrir la lección interactiva →