Fundamentos de API REST

Parte del curso de Web

Te piden añadir un endpoint a una API que ya existe y te quedas bloqueado en la primera decisión: ¿es POST /users/42/deactivate o PATCH /users/42? Las dos funcionan. Las dos van a salir. Pero una le resultará evidente a la siguiente persona y la otra abrirá una discusión en la revisión de código.

Imagina un archivador. Cada cajón y cada carpeta tienen una dirección, y la dirección nunca dice qué piensas hacer cuando llegues allí. Hacer algo es una decisión aparte: leerlo, sustituirlo, tirarlo. REST parte una API de la misma manera. La URL es la dirección de una cosa. El método HTTP es el verbo. ...