Criar conceções de API que sejam consistentes, reutilizáveis e baseados na intenção de negócios e em padrões compartilhados.
Conceber APIs não se resume apenas a nomear endpoints. Um bom projeto garante que as APIs sejam utilizáveis, consistentes e alinhadas com os objetivos de negócio e técnicos. Um projeto inadequado leva a um acoplamento rígido, baixa reutilização e retrabalho dispendioso entre as equipas.
Sua rota no mapa
Navegar pelo método
Selecione uma estação, ciclo ou perspectiva para explorar o método.
Resultados
Conceção de API bem documentada e coerente
Contratos de interface da API reutilizáveis e validados
Desenhos alinhados com modelos de domínio e padrões de interação
Rastreabilidade da conceção ao valor de negócio
Critérios do percurso
Critérios de entrada
A capacidade responde a uma necessidade clara de negócio e é reutilizável pelos utilizadores previstos.
A interface selecionada fornece uma abstração adequada aos utilizadores.
A proposta de valor da capacidade foi validada com partes interessadas de negócio e utilizadores.
Os segmentos de utilizadores estão identificados.
Está definido um roadmap de implementação de alto nível.
Critérios de saída
A arquitetura, plataforma e estilo de implementação escolhidos foram validados com as partes interessadas relevantes de arquitetura, segurança e plataforma.
A interface selecionada fornece uma abstração adequada aos utilizadores.
O desenho da interface e as capacidades expostas são rastreáveis ao valor de negócio e às necessidades dos utilizadores.
O desenho da interface segue os standards e convenções de desenho acordados.