Tarea 1.8 Investigación Sobre Rest, Restful y OpenApi

NOMBRE DEL ALUMNO:
J. Ulisses Gastelum V.
NOMBRE DEL PROFESOR/A:

Molina Gonzales, David
TITULO DEL TRABAJO:

1.8 Investigación sobre Rest, Restful y
OpenApi
CLASE:
Taller de Base de Datos
FECHA:
08/09/24
REST (Representational State Transfer):
 Origen del concepto REST:
El concepto de REST (Representational State Transfer) fue introducido por Roy
Fielding en su tesis doctoral en el año 2000 como un estilo arquitectónico para
diseñar sistemas distribuidos, especialmente para la World Wide Web. Fielding fue
uno de los autores principales de las especificaciones del protocolo HTTP, y
desarrolló REST como un modelo teórico para comprender mejor cómo debería
funcionar la web a gran escala.
 Principios fundamentales de REST
1. Statelessness: En REST, cada solicitud del cliente al servidor debe
contener toda la información necesaria para que el servidor entienda y
procese la solicitud. Esto significa que el servidor no debe almacenar
ningún estado relacionado con la interacción previa con el cliente. Cada
solicitud es independiente de las demás. Esto hace que REST sea
escalable, ya que el servidor no tiene que almacenar información adicional
sobre las sesiones de los usuarios.
2. Representación de recursos: En REST, los recursos (datos o servicios) se
identifican mediante URIs. Los recursos pueden ser cualquier cosa, como
un archivo, una base de datos, o un servicio. La representación de un
recurso se transfiere entre el servidor y el cliente en diferentes formatos
como JSON, XML, o HTML, según las necesidades de la aplicación y la
preferencia del cliente.
3. URI (Uniform Resource Identifier): Los recursos en REST son accesibles
a través de un URI, que es una dirección única que identifica al recurso en
la web. Cada recurso tiene una URI única y bien definida, lo que facilita su
acceso y manipulación.
RESTful
 Características de una API RESTful:
1. Uso de recursos con URIs (Uniform Resource Identifiers): En una API
RESTful, cada recurso tiene una URI única que lo identifica. Los recursos
son entidades como usuarios, productos, o pedidos, y cada uno se accede
a través de una URI que representa su dirección única.
2. Statelessness: Las API RESTful son stateless, lo que significa que cada
solicitud del cliente contiene toda la información necesaria para procesarla.
El servidor no debe almacenar el estado de las interacciones pasadas del
cliente. Esto simplifica la escalabilidad y reduce la complejidad del manejo
de sesiones.
3. Capacidad para escalar y dividirse en capas: Una API RESTful permite que
la arquitectura esté dividida en capas, lo que mejora la escalabilidad y
seguridad. Los clientes no necesitan saber si se están comunicando
directamente con el servidor de backend o con otro servidor intermedio.
 Ejemplos de prácticas en el diseño APIs RESTful:
1. Control de versiones de la API: Versionar la API es crucial para mantener
la compatibilidad con clientes antiguos cuando se realizan cambios
importantes. Una forma común es incluir la versión en la URI.
2. Documentacion clara y precisa: Documentar la API es esencial. Usar
herramientas como Swagger o OpenAPI permite crear documentación
interactiva y fácil de entender para los desarrolladores que van a utilizar la
API.
3. Paginacion, filtrado y ordenación: Para evitar sobrecargar el servidor con
solicitudes que devuelvan grandes cantidades de datos, es recomendable
implementar paginación y filtros.
OpenAPI
 Que es OpenAPI:
Es un estándar para definir y describir APIs RESTful de manera estructurada y
comprensible tanto por humanos como por máquinas. Anteriormente conocido
como Swagger, se convirtió en OpenAPI cuando la especificación fue adquirida
por la OpenAPI Initiative. OpenAPI permite a los desarrolladores definir la
estructura y comportamiento de una API de manera formal mediante un archivo en
formato JSON o YAML, lo que facilita el diseño, la documentación y el consumo
de las APIs.
 Como facilita OpenAPI el diseño, documentación y consumo de APIs:
1. Diseño de APIs: Con OpenAPI, los desarrolladores pueden planificar la API
antes de comenzar a escribir el código. Esto permite definir todos los
recursos, endpoints, parámetros, respuestas, códigos de estado HTTP, y
mucho más de manera estructurada.
2. Documentación automática: Uno de los principales beneficios de
OpenAPI es que, a partir de la especificación, es posible generar
documentación legible para humanos que detalla cómo interactuar con la
API. Herramientas como Swagger UI o ReDoc pueden crear interfaces
interactivas para que los desarrolladores exploren la API.
3. Versionando y cambios: OpenAPI facilita el versionado de las APIs,
permitiendo hacer un seguimiento claro de las modificaciones y
actualizaciones en la API. Esto es importante para mantener la
compatibilidad hacia atrás y para comunicar adecuadamente los cambios a
los consumidores de la API.

Tarea 1.8 Investigación Sobre Rest, Restful y OpenApi

Cargado por

Copyright:

Formatos disponibles

Tarea 1.8 Investigación Sobre Rest, Restful y OpenApi

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Tarea 1.8 Investigación Sobre Rest, Restful y OpenApi

Cargado por

Copyright:

Formatos disponibles

NOMBRE DEL ALUMNO:

NOMBRE DEL PROFESOR/A:

TITULO DEL TRABAJO:

También podría gustarte