Tratar APIs como producto significa priorizar la experiencia del desarrollador(a), no s¨®lo mediante un dise?o razonable y estandarizado de dichas APIs sino tambi¨¦n proporcionando una documentaci¨®n completa y una experiencia de onboarding fluida. Aunque las especificaciones de OpenAPI (Swagger) pueden documentar interfaces de APIs de manera efectiva, el onboarding contin¨²a siendo un desaf¨ªo. Los desarrolladores(as) necesitan acceso r¨¢pido a ejemplos funcionales, con autenticaci¨®n pre-configurada y datos de prueba realistas. Con la evoluci¨®n de herramientas de clientes API (como Postman, Bruno e Insomnia), recomendamos tratar las colecciones de peticiones API como artefactos del producto API. Las colecciones de peticiones API deben ser dise?adas cuidadosamente para guiar a los desarrolladores(as) a trav¨¦s de flujos de trabajo clave, ayud¨¢ndoles a comprender el lenguaje y funcionalidad del dominio de la API con el m¨ªnimo esfuerzo. Para mantener estas colecciones actualizadas, recomendamos almacenarlas en un repositorio e integrarlas dentro del pipeline de despliegue de la API.
