Tratar APIs como produto significa priorizar a experi¨ºncia da pessoa desenvolvedora, n?o apenas inserindo um design sensato e padronizado nas pr¨®prias APIs, mas tamb¨¦m fornecendo documenta??es abrangentes e boas experi¨ºncias de onboarding. Embora as especifica??es de OpenAPI (Swagger) possam documentar as interfaces de APIs efetivamente, o onboarding permanece um desafio. As desenvolvedoras precisam de acesso r¨¢pido a exemplos funcionais, com autentica??o pr¨¦-configurada e dados de testes realistas. Com o amadurecimento de ferramentas de clientes de API (como Postman, Bruno e Insomnia), recomendamos tratar a cole??o de requisi??es de API como um artefato do produto. Essas cole??es devem ser cuidadosamente projetadas para guiar efetivamente as desenvolvedoras atrav¨¦s dos principais fluxos de trabalho, auxiliando na compreens?o da funcionalidade e linguagem de dom¨ªnio da API com o m¨ªnimo de esfor?o. Para manter as cole??es atualizadas, recomendamos armazen¨¢-las em um reposit¨®rio e integrar ao pipeline de entrega das APIs.
