Usuários tem retrabalhos e fricções ao longo da jornada de design de APIs

[gsmjaoy]

The Pain

Usuários tem dificuldades de executar ações em caso de falha na esteira

Summary

Para mitigar riscos de vazamento de dados sensíveis e prover uma melhor experiencia aos consumidores de APIs sejam eles internos ou externos, existem alguns padrões estabelecidos baseados em boas práticas de mercado.
Porém, devido a falta de conhecimento de alguns usuários no design de APIs e geração de contratos, algumas falhas ocorrem na esteira princialmente no step de validação. Com isso, os usuários tem dificuldades em interpretar o erro e executar adequações de forma rápida. Além de gerar insatisfação do usuário, esses problemas geram retrabalhos devido a necessidade de reexecução da esteira. Em alguns casos os usuários abrem tickets para auxiliar na resolução do problema.

Goal

Facilitar a jornada de design de APIs, reduzir a quantidade de retrabalhos gerados por falhas na esteira e fricções ao longo da jornada

Possible Features

• Actions para validar os padrões em tempo de design, sem a necessidade de execução da esteira - Entregue (R3)
• Interface para guiar o usuario e evitar que ocorram falhas. Apresentar mensagens intuitivas
• Agente de AI para auxiliar na identificação do problema e gerar recomendações ao usuário

Metrics

• Reduzir de 26% para 20% a quantidade de falhas ao longo da jornada
• Reduzir de X para Y a quantidade de tickets abertos pelos usuários

Frequency

Atualmente 26% do total de execuções da esteira falham

Coverage

Ocorre principalmente com pessoas desenvolvedoras que iniciaram recentemente no contexto de APIs e que não possuem tanta experiência com a expecificação open API.

[cadupereira-zup]

@fabriciostackspot mesmo comentário da issue #175