O que importa para mim são algumas características principais: governança aberta, roteiro transparente, rigor técnico, documentação clara, ferramentas confiáveis e neutralidade genuína do fornecedor.Se a documentação for confusa, houver problemas com a especificação e as pessoas não puderem usá-la para cumprir seus casos de uso, será difícil confiar.Você deveria definir sua API usando AsyncAPI, OpenAPI, Smithy ou TypeSpec, apenas para citar alguns formatos?Portanto, um formato de especificação de API é, de certa forma, muito mais importante do que qualquer solução técnica pode ter.Por fim, procuraria ferramentas atualizadas, como geradores de SDK, formas de gerar documentação e linters.
Fonte: https://apichangelog.substack.com/p/the-hidden-trust-problem-in-api-formats
