Crie um token GanttFather API, chame a v1 REST API com segurança, administre cotas e idempotência e escolha entre REST e MCP.
O GanttFather REST API expõe operações versionadas de projetos, tarefas, dependências, membros e recursos para scripts e integrações. Autentique com um token GanttFather, envie um cabeçalho User-Agent não vazio, comece com chamadas de leitura e use uma Idempotency-Key ao criar uma tarefa ou recurso que pode ser repetido.
Comportamento deAPI verificado em 7 de agosto de 2026. Trate o referência ativa de API como o contrato de nível de endpoint.
O que você pode automatizar com GanttFather API?
A v1 API oferece suporte a fluxos de trabalho comuns de integração de cronograma:
- listar projetos acessíveis e inspecionar um projeto
- listar e ler tarefas, membros, recursos e dependências
- criar, atualizar parcialmente, reordenar e excluir tarefas
- adicionar ou remover dependências de tarefas
- criar, atualizar e excluir recursos
- anexe seu próprio mapeamento entre um registro externo e um ID GanttFather
O API público não é a mesma superfície que o API interno do navegador. Use apenas terminais v1 e campos de resposta documentados.
Como você cria e usa um token API?
Abra GanttFather, vá para Configurações → Agentes de IA e API e crie um token com o menor escopo e permissão úteis. Copie o token bruto quando ele for mostrado e armazene-o em um gerenciador secreto; GanttFather não armazena o valor bruto para exibição posterior.
Então siga esta sequência:
- Leia o guia de autenticação.
- Ligue listar projetos para encontrar um ID de projeto acessível.
- Leia as tarefas antes de tentar escrever.
- Crie uma tarefa de teste descartável.
- Adicione paginação, novas tentativas e manipulação de cotas antes de um trabalho em massa.
Cada solicitação deve incluir o token Bearer e um User-Agent não vazio que identifique o cliente. Um User-Agent ausente é rejeitado antes do tratamento normal do endpoint.
Quais regras de segurança são importantes para gravações?
Use atualizações parciais apenas para campos de propriedade da sua integração. Leia o estado atual antes de alterá-lo, registre ids estáveis e informações de rastreamento e não transforme todos os campos externos em uma substituição incondicional.
Para criação de tarefas e recursos, envie uma Chave de Idempotência quando um tempo limite ou falha de rede puder causar uma nova tentativa. Reutilizar a chave com a mesma solicitação retorna o resultado anterior; reutilizá-lo com uma solicitação diferente é um conflito. Atualizações e exclusões têm sua semântica documentada e não aceitam essa chave somente de criação como um mecanismo universal de desduplicação.
Dependências e hierarquia são preocupações separadas. A reordenação é a forma sancionada de alterar o posicionamento dos pais; pontos de extremidade de dependência modelam relacionamentos predecessores. Valide ambos em vez de derivar um do outro.
Quais são os limites de taxas e cotas diárias?
A proteção padrão é 60 solicitações por minuto por token autenticado e 5.000 solicitações por dia por token. Uma resposta limitada usa HTTP 429 e fornece informações sobre novas tentativas. Verifique o atual limites de taxas e documentação de cotas antes de planejar uma carga de trabalho de produção porque os limites operacionais podem mudar.
Reduza o volume de solicitações paginando corretamente, lendo em lotes, armazenando em cache IDs estáveis e enviando uma atualização parcial em vez de uma sequência de atualizações por campo. Um loop de nova tentativa deve respeitar Retry-After e usar backoff exponencial limitado com jitter.
Quando você deve usar REST em vez de MCP?
Use REST quando o código determinístico do aplicativo precisar de recursos HTTP versionados, respostas de erro explícitas e comportamento de repetição controlado. Use o Servidor MCP quando um cliente de IA como Claude deve invocar ferramentas de projeto de nível superior por meio de Model Context Protocol.
Ambos podem usar a token lane de GanttFather, mas suas operações e entradas de idempotência não são intercambiáveis. Uma integração API deve seguir a referência REST; um agente deve seguir as descrições da ferramenta MCP.
O que é um primeiro padrão de integração seguro?
Comece com uma direção e um proprietário para cada campo:
| Passo | Comportamento recomendado |
|---|---|
| Descubra | Liste projetos e registre o ID do projeto selecionado |
| Leia | Percorra as tarefas atuais e crie um mapa de identificação |
| Comparar | Calcular um conjunto de alterações sem escrever |
| Revisão | Registrar criações, atualizações e exclusões pretendidas |
| Escreva | Aplique a menor mutação suportada |
| Verifique | Leia o resultado e registre o id retornado |
Não reivindique “sincronização” até que a propriedade do conflito, as regras de exclusão, as novas tentativas e a recuperação sejam definidas.
Quando você deve desenvolver GanttFather API?
Use API quando um formulário, pipeline de implantação, portal do cliente ou sistema interno precisar de acesso repetível aos mesmos dados do projeto que sua equipe vê em GanttFather. O primeiro caso de uso mais confiável é restrito (por exemplo, criar um marco de lançamento após a implantação) e depois expandir após observar falhas e novas tentativas reais.
O API não decide qual sistema possui um campo nem torna um fluxo de trabalho multissistema livre de conflitos. Sua integração deve definir essas regras.
Crie um projeto GanttFather, emita um token de privilégio mínimo e teste os dados descartáveis antes de conectar os registros de produção.
Perguntas frequentes
O acesso de API está incluído no nível gratuito?
O acesso de API está atualmente disponível nos planos GanttFather. Os limites de capacidade e proteção ainda se aplicam; verifique o página de preços e documentação de cota API para os termos atuais.
Qual é a aparência de um token GanttFather API?
Os tokens usam o formato de token GanttFather e são apresentados como credenciais de portador. Nunca confirme um token para controle de origem ou inclua-o em um log público.
O User-Agent é opcional?
Não para solicitações normais da v1. Envie um valor não vazio que identifique sua integração, como nome e versão do produto.
Toda solicitação deve incluir uma chave de idempotência?
Não. Use-o para operações de criação documentadas quando a mesma solicitação puder ser repetida. Não é uma versão de uso geral ou um cabeçalho de simultaneidade.
O API pode configurar fontes de integração do Azure DevOps?
Os dados públicos do projeto v1 API e a integração do produto Azure DevOps são superfícies separadas. Não presuma que existe um endpoint de integração não documentado.
Onde está a documentação do OpenAPI?
Comece do GanttFather API introdução e siga os links de referência para autenticação, endpoints, esquemas e erros.
