API REST (transferencia de estado representativa): un estilo arquitectónico que utiliza implementaciones cliente-servidor de forma independiente. REST utiliza el protocolo HTTP para la comunicación.

Los componentes principales de la API REST:

• Cliente — un cliente o programa lanzado en el lado del usuario (en su dispositivo) iniciando la comunicación.
• Servidor — un servidor que utiliza API como acceso a sus funciones y datos.
• Recurso — cualquier contenido (video, texto, imagen) que el servidor transmite al cliente.

Y luego usas los métodos HTTP para interactuar con esos recursos:

• GET → para obtener información (leer).
• POST → para crear algo nuevo.
• PUT → para actualizar algo existente.
• DELETE → para eliminar algo.
• Cuando se hace una solicitud GET a una API, el servidor puede responder con una variedad de códigos de estado HTTP. Algunos de los más comunes incluyen:

Acceder a los recursos del servidor:

Para acceder a un recurso, un cliente debe realizar una solicitud. Después de recibirlo, el servidor generará una respuesta con datos codificados sobre un recurso. Cuando se realiza una solicitud HTTP a una API, esta suele componerse de cuatro elementos principales:

1. Método HTTP:

   Define la acción que quieres realizar sobre el recurso. Ejemplos:

   • GET para obtener datos.
   • POST para crear un nuevo recurso.
   • PUT para actualizar uno existente.
   • DELETE para eliminarlo.

2. Endpoint (URL del recurso):

   Es la dirección que identifica qué recurso específico quieres manipular. Al construir esta URL, debes considerar varios componentes:

   1. Base de la URL: Esta es la parte constante de la URL a la que se realizan las solicitudes. Esto generalmente incluye el protocolo (como http o https), el dominio o servidor de la API y posiblemente una parte del path que es común a todos los endpoints de la API. Por ejemplo, en https://api.ejemplo.com/usuarios, la base de la URL sería https://api.ejemplo.com.
   2. Endpoint del recurso: Este es el path específico de la URL que identifica el recurso que se está accediendo. En el ejemplo anterior, el endpoint del recurso sería /usuarios.
   3. Parámetros de consulta (opcional): Estos son pares clave-valor que se agregan al final de la URL, y que permiten especificar detalles adicionales sobre la solicitud. Por ejemplo, puedes usar parámetros de consulta para filtrar o clasificar los resultados de una solicitud GET. Los parámetros de consulta se introducen después de un signo de interrogación (?) y se separan por un ampersand (&).

   Ejemplo de URL :https://api.ejemplo.com/usuarios?ordenarPor=nombre&limite=10

3. Encabezados (Headers):

   Son metadatos adicionales que acompañan la solicitud, indicando información como:

   • El formato de los datos enviados o recibidos (Content-Type: application/json).
   • Autenticación (Authorization: Bearer <token>).
   • Otros detalles técnicos necesarios.

4. Cuerpo de la solicitud (Body) (opcional):

   Se usa principalmente en métodos como POST y PUT. Aquí envías los datos que quieres guardar o actualizar en el servidor, normalmente en formato JSON, XML u otro.