Consider OpenAPI

OpenAPI provides a way to [declare your RESTful API](https://swagger.io/specification/), much like .proto files in gRPC, and have server stubs and client proxies be auto-generated for a variety of languages. It would be a much less error prone and maintainable way for us to declare our RESTful APIs.

Comienza revisando cómo este repositorio declara actualmente sus RESTful APIs y cómo sus archivos .proto admiten gRPC. Compara el enfoque existente con la especificación de OpenAPI, los server stubs y los client proxies; el issue no define un alcance objetivo ni criterios de aceptación, por lo que actualmente no está claro cuándo se considerará completado.

Escrito por el modelo de indexación a partir del texto del issue.