Endpoints y REST, en términos sencillos

Un endpoint (punto de acceso) es un solo elemento del menú. Es simplemente una URL (Uniform Resource Locator, localizador uniforme de recursos) que hace una cosa específica. Por ejemplo:

• https://api.weather.com/forecast — obtener un pronóstico
• https://api.weather.com/cities — listar las ciudades disponibles

Misma cocina, platos diferentes. Cada endpoint es una capacidad.

La mayoría de las APIs con las que trabajarás siguen un estilo relajado llamado REST (Representational State Transfer, transferencia de estado representacional). No necesitas la definición académica; necesitas dos ideas:

• La URL nombra una cosa (un "recurso") — un usuario, un pedido, un pronóstico.
• El verbo dice qué quieres hacer con ella. Estos verbos son métodos HTTP (HyperText Transfer Protocol, protocolo de transferencia de hipertexto), los mismos que vienen del capítulo sobre cómo funciona la web:
  • GET — leer algo (obtener un pronóstico). Seguro; no cambia nada.
  • POST — crear algo (hacer un pedido, registrar un usuario).
  • PUT / PATCH — actualizar algo que ya existe.
  • DELETE — eliminar algo.

Entonces GET /orders/42 significa "lee el pedido número 42", y DELETE /orders/42 significa "elimínalo". Mismo sustantivo, verbo diferente, efecto completamente distinto. Cuando leas documentación de API o un diff, esas dos palabras —el método y la URL— te dicen la mayor parte de lo que hace una solicitud.