Lo que necesitas saber sobre APIs en desarrollo web

Introducción

Las letras API representan “Application Programming Interface” que en español se traduce como Aplicación de Interfaz Programada (mi definición) o Interfaz de programación de aplicaciones (la de google).

En otras palabras, un API es una colección de datos que se encuentra en una base de datos y nosotros podemos hacer solicitudes con diferentes propósitos. Entre los más populares se encuentran:

Los métodos más comunes:

1. GET – leer datos
2. POST – guardar datos
3. UPDATE – actualizar datos
4. DELETE – eliminar datos

Esto es lo que se llama el CRUD (Create [crear], Read [leer], Update [actualizar], Delete [eliminar]).

¿Cómo se solicita data a un API?

Para solicitar datos a un API necesitas conocer lo que se llama el “endpoint” o terminal. El “enpoint” o terminal es un URL al cual accesamos los datos. Sin embargo, vale mencionar que existen tipos de “enpoints” o terminales públicos y privados.

Tipos de endpoint

1. Privado – requiere de autenticación para poder tener acceso a la data.
2. Público – no requiere de autenticación para tener acceso a la data, estaremos viendo ejemplos de esto.

Request & Response (Solicitud y Respuesta)

Cuando solicitamos la data, esperamos una respuesta. Esto se conoce como el proceso de solicitud y respuesta o en inglés request & response. Al momento de hacer la solicitud el servidor hace los procesos necesarios para enviar una respuesta.

Status de la respuesta (estado)

Cada vez que hacemos una solicitud, dependiendo de la respuesta, la misma va acompañada de un status. Por ejemplos, si la respuesta es correcta, usualmente se utiliza un status en los 200 (ok), si el “endpoint” o terminal no existe, recibirás un status en los 404 (not found [no encontrado]), si necesitas autenticación y no fue provista puedes un 401 (unauthorized [no autorizado]) o 403 (forbidden [prohibido]) etc. Puedes conocer los status de las respuestas en el siguiente enlace, así como más información sobre los diferentes métodos que existen para hacer solicitudes a un API.

https://www.softwaretestinghelp.com/rest-api-response-codes/

Aplicaciones para desarrollar API’s

1. Postman
2. Browser con extensiones
3. Extensiones en VS Code (ej. RapidAPI Client)
4. Swagger
5. Insomnia
6. Otros…

Cómo se crea un API (pasos generales)

1. Inicia el servidor backend (ej. express.js, django)
2. Conecta la base de datos
3. Crea los modelos*
4. Crea los endpoints (terminales)
5. Añado autenticación de ser necesario

En el siguiente video tutorial

1. Estaremos consumiendo un API en el navegador
2. Estaremos haciendo introducción a Postman, una herramienta popular para desarrollar y trabajar con APIs
3. Hablaremos de parámetros tanto en el URL como en la creación de API’s
4. Hablaremos de parámetros tanto en el URL como en la creación de API’s
5. Estaremos usando JSON Server para simular algunos requests (solicitudes) y mostrarlos en la pantalla con REACT

Puedes ver la lista de videos completa en el siguiente enlace https://www.youtube.com/watch?v=RUyoak8o6xo&list=PL-6N9BFZQLq6ysWrQyxWzvaRTgmzvWrbx&index=1.