Hay varias formas de construir APIs, pero la más común es REST. Funciona sobre la web, igual que las páginas que visitas, y se basa en dos ideas: direcciones y verbos.

La dirección (URL o endpoint) dice sobre qué estás preguntando, como la sección de la carta:

https://api.mitienda.co/productos
https://api.mitienda.co/productos/25
https://api.mitienda.co/pedidos

El verbo (método HTTP) dice qué quieres hacer:

• GET: tráeme (consultar productos).
• POST: crea (registrar un pedido nuevo).
• PUT o PATCH: cambia (actualizar el precio).
• DELETE: borra (eliminar un producto).

Cada respuesta trae un código de estado, un número que resume cómo te fue. Los que empiezan por 2 son buenas noticias (200 OK, 201 creado). Los que empiezan por 4 indican que tú pediste algo mal (404 no existe). Los que empiezan por 5 indican que falló el servidor.

💡 Tip: cuando leas la documentación de una API, busca primero la lista de endpoints y los verbos que acepta cada uno. Es la carta del restaurante.