OpenAPI, Swagger UI y api-platform

Hay herramientas como stoplight, que permiten hacer la documentación manualmente y publicarla.

Pero como recomendación busquen que sus APIs ya autogeneren la documentación, es medio pesado hacerlo manualmente. Ya FastApi de Python lo hace, en Nextjs para JavaScript se puede configurar y ahora para Symfony con esta herramienta 😄

Notas Mentales * Podemos usar herramientas para apoyarno en crear APIs, para este ejemplo usaremos: * Open AI: * Es un estandar para escribir APIs * Radica en el conjunto de reglas y formatos que describen la estructura de nuestro sistema * Podemos pensar que Open AI es como un manual que podemos seguir paso a paso * Podemos definir lo esencial que operaciones se pueden hacer, que parametros recibe y que respuestas podemos esperar * Swagger UI: * Nos proporciona una interfaz visual para nuestras APIs * Nos permite crear una documentación interactiva * Dicha Documentacion se basa en los standares de Open IA * La documentacion se genra d emanera automática * API Platform: * Es un componente que se instala en symfony 6 para crar APIs * Usa internamente a Open AI y Swagger UI > Resumen: Usamos framework symfony 6 -> Instalamos ->API Platform -> que usa los standares -> Opean AI && Swagger UI -> para crear APis

Si están usando symfony-cli, en lugar de usar `php bin/console`, se puede usar `symfony console`