Capítulo 1. Diseñar, construir y especificar API
Este trabajo se ha traducido utilizando IA. Agradecemos tus opiniones y comentarios: translation-feedback@oreilly.com
Se te presentarán muchas opciones cuando diseñes y construyas API. Es increíblemente rápido construir un servicio con tecnologías y marcos modernos, pero crear un enfoque duradero requiere una reflexión y una consideración cuidadosas. En este capítulo exploraremos REST y RPC para modelar las relaciones productor y consumidor en el caso práctico.
Descubrirás cómo las normas pueden ayudar a acortar las decisiones de diseño y alejarse de posibles problemas de compatibilidad. Verás las especificaciones OpenAPI, los usos prácticos para los equipos y la importancia del versionado.
Las interacciones basadas en RPC se especifican utilizando un esquema; para comparar y contrastar con un enfoque REST, exploraremos gRPC. Teniendo en cuenta tanto REST como gRPC, estudiaremos los distintos factores que hay que tener en cuenta a la hora de modelar los intercambios. Estudiaremos la posibilidad de proporcionar tanto una API REST como RPC en el mismo servicio y si es lo correcto.
Caso práctico: Diseño de la API de asistentes
En la Introducción decidimos migrar nuestro sistema de conferencias heredado y pasar a una arquitectura más basada en API. Como primer paso para realizar este cambio, vamos a crear un nuevo servicio de Asistentes, que expondrá una API de Asistentes correspondiente. También ofrecimos una definición restringida ...