Este guia irá ajudá-lo a começar rapidamente, desde a configuração da sua conta até à realização dos seus primeiros pedidos de API.Guia em vídeo#
Pré-requisitos#
Antes de começar, certifique-se de que tem:1.
Configuração da conta: Registe-se para obter uma conta gratuita Apidog em app.apidog.com, caso ainda não o tenha feito. 2.
Iniciar sessão: Inicie sessão na aplicação Web do Apidog ou na aplicação cliente (Transfira Aqui). O projeto Pet Store é um exemplo integrado do Apidog que o ajuda a aprender conceitos e funcionalidades essenciais. Comece clicando em Create Sample Project na página de boas-vindas do Apidog. Escolha o seu modelo de desenvolvimento#
O Apidog suporta duas abordagens principais de desenvolvimento de APIs:| Modelo | Descrição | Mais indicado para | Fluxo de trabalho |
|---|
| Design-first | Definir especificações de API antes da implementação | Equipas que dão prioridade ao planeamento e à documentação | Especificação → Pedido → Teste → Partilhar |
| Request-first | Criar e testar APIs a partir de pedidos reais | Equipas ágeis, prototipagem, APIs sem documentação | Pedido → Especificação → Teste → Partilhar |
Ambos os modelos são totalmente suportados e podem ser alternados a qualquer momento. Escolha com base nas preferências de fluxo de trabalho da sua equipa. Saiba mais sobre o Modo Design-first e o Modo Request-first. Modelo Design-first#
Na abordagem Design-first, você define previamente as especificações da sua API, garantindo clareza e consistência antes da implementação. Este método é ideal para equipas que dão prioridade ao planeamento e pretendem criar documentação abrangente desde o início.1
Especificar um novo endpointDefina o endpoint da sua API com caminho, método, parâmetros e respostas. Isto cria a base da especificação da sua API.
2
Mudar para o modo Design-firstNo canto inferior esquerdo da interface do Apidog, selecione o modo "Design-first" para continuar a conceber o seu endpoint.
4
Adicionar uma asserçãoConfigure verificações automatizadas para garantir que as respostas da sua API cumprem os critérios esperados.
Começar com Design-first
Especifique o seu primeiro endpointModelo Request-first#
A abordagem Request-first começa com chamadas reais à API, permitindo-lhe prototipar e validar APIs rapidamente. Este método é perfeito para equipas que trabalham com backends existentes, APIs de terceiros ou quando precisa de documentar endpoints sem documentação.1
Enviar um pedidoFaça uma chamada de API para testar ou explorar um endpoint existente.
3
Adicionar uma asserçãoImplemente regras de validação automatizadas para garantir a fiabilidade e a correção da API.
Começar com Request-first
Envie o seu primeiro pedidoAlternar entre modos#
Pode alternar entre os modos Design-first e Request-first a qualquer momento utilizando o seletor no canto inferior esquerdo da interface:Esta flexibilidade permite-lhe adaptar o seu fluxo de trabalho à medida que o seu projeto evolui. Modified at 2026-06-09 08:54:45