Explique los principios y la ideología principal de la API RESTful

RESTful API es un estilo arquitectónico para crear servicios web, basado en los principios de REST (Transferencia de Estado Representacional). Ideas principales:

• Recursos: Todo lo que trabaja con la API se presenta como recursos (por ejemplo, usuarios, productos), que se identifican mediante URI únicos.

• Métodos HTTP: Para interactuar con los recursos se utilizan métodos HTTP estándar:

  • GET — obtener datos del recurso;
  • POST — crear un nuevo recurso;
  • PUT — actualizar el recurso;
  • DELETE — eliminar el recurso.

• Códigos de estado: Las respuestas del servidor contienen códigos de estado HTTP que informan sobre el resultado de la operación (por ejemplo, 200 OK, 404 No Encontrado).

• Sin estado (stateless): Cada solicitud del cliente al servidor debe contener toda la información necesaria para procesarla, el servidor no mantiene estado entre solicitudes.

• Caché: Las respuestas pueden ser almacenadas en caché para mejorar el rendimiento.

• Interfaz uniforme: Facilita la interacción y comprensión de la API.

Ejemplo de una solicitud a RESTful API para obtener la lista de usuarios:

GET /users HTTP/1.1
Host: example.com
Accept: application/json

Respuesta:

[
  {"id": 1, "name": "Иван"},
  {"id": 2, "name": "Мария"}
]

De esta manera, RESTful API proporciona una interacción sencilla, comprensible y estandarizada entre cliente y servidor.