Centra-se nos princípios e práticas de conceção de APIs.
QuemNão selecionadoPor quêNão selecionadoOndeConceção da APICicloCiclo de Produto de APILinha de conceção de API
Estação
Conceção da API
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.
Pessoas a envolver
Recursos relacionados
Canvas de InteraçãoDefinir interações API, fluxos de trabalho e respostas esperadas para garantir uma experiência consistente do utilizador API.Canvas RESTConceber APIs utilizando os princípios RESTful, definindo recursos, verbos e exemplos de pedidos e respostas.Canvas de EventosConceber APIs orientadas para eventos, definindo eventos, accionadores e lógica de processamento.Princípios de conceção da APIUm guia conciso sobre usabilidade, descobribilidade e consistência da API, baseado em regras de design partilhadas e nas necessidades reais dos utilizadores.Canvas de DomínioUma ferramenta de modelação para definir e comunicar as principais entidades e relações no seu domínio, assegurando a consistência semântica entre APIs.