Pedir o enviar: los dos gestos básicos

Imagen libre de Wikimedia Commons (CC BY 4.0, autor: https://commons.wikimedia.org)

Toda llamada a una API hace, en el fondo, una de dos cosas: pedir información o enviar información para que algo cambie. Esos dos gestos tienen nombre: GET para pedir, POST para enviar. No necesitas memorizar la teoría REST. Te basta con una regla simple: si la acción no cambia nada en el servicio, es un GET; si crea o modifica algo, suele ser un POST.

GET mira, POST mueve. La mayoría de las APIs también usan PUT/PATCH (editar) y DELETE (borrar).
Método	Qué hace	Ejemplo	¿Cambia algo?
GET	Pide datos	Consultar el saldo de una cuenta	No
GET	Lista información	Traer los 10 últimos clientes	No
POST	Envía datos para crear	Registrar una venta nueva	Sí
POST	Provoca una acción	Pedirle a un modelo de IA un texto	Sí

JSON: el formato en que te contestan

Las respuestas casi siempre llegan en JSON: texto estructurado con llaves, comas y pares de clave y valor. Se lee casi como una ficha. Una respuesta de clima puede verse así:

Ejemplo de respuesta JSON

No le temas a las llaves Tu trabajo no es escribir JSON a mano. Es leerlo: reconocer que temperatura es un número y condicion es un texto, para decirle a tu app qué campo mostrar.

Tu app necesita mostrar el listado de ventas del mes sin alterar nada. ¿Qué método de API corresponde?

Registrar un cliente nuevo en un CRM mediante una API es, casi siempre, una llamada POST.

Empareja cada término con lo que hace.

Un colega describe una llamada y se equivoca en una línea. Marca dónde está el error.

Quiero traer la lista de productos: haré un GET al endpoint de productos.
Para borrar un producto usaré un GET, porque GET sirve para hacer cambios.
La respuesta viene en JSON y leeré el campo precio.

Identifica la linea con error.

Elige una función de tu idea (mostrar algo o guardar algo) y describe cómo hablaría con su API: ¿GET o POST? y ¿qué campos del JSON necesitaría tu app?

Pista

Nombra al menos dos campos, por ejemplo precio y nombre, para practicar la lectura de JSON.

GET pide sin cambiar; POST envía para crear o accionar.
JSON es el formato: clave y valor, legible como una ficha.
El endpoint es la dirección de cada función del servicio.

Siguiente paso: Tokens y autenticación — cómo se identifica tu app ante la API sin exponer tus llaves.