Documentação
API REST: guia rápido e referência
Autenticação com chave de API, limites de frequência, paginação e referência OpenAPI 3.1.
Automatização e programadores
API REST para ler e escrever os planos
Projetos, tarefas, atribuições e dependências através de uma API REST, com chaves de API de permissões limitadas e referência OpenAPI 3.1.
- Disponível
- Gratuita, incluída em todas as contas
O que faz
Webhooks e API REST para as suas próprias automatizações
Para tudo o que não tem uma integração pronta: um evento assinado assim que algo muda e uma API para ler e escrever o plano.
Para que serve
- Ligar o Planitude a um sistema interno, a um ERP ou a um data warehouse.
- Iniciar uma automatização assim que uma tarefa é concluída ou movida.
- Criar projetos e tarefas a partir de outra ferramenta, sem os copiar à mão.
Do Planitude para O seu sistema
- Cada alteração, venha ela da app web, da API, de MCP ou de uma importação → Eventos assinados, Do Planitude para O seu sistema
Nas duas direções
- Projetos, tarefas, atribuições e dependências ↔ Leitura e escrita via API REST, Nas duas direções
Configuração
Como se liga, em três passos
Crie uma chave de API
Em Perfil → Chaves de API, só de leitura ou de leitura e escrita, opcionalmente limitada a um espaço de trabalho e com data de expiração.
Registe um webhook
Num projeto ou num espaço de trabalho inteiro, escolhendo entre 14 eventos: tarefas criadas, concluídas ou movidas, dependências, linhas de base, comentários e outros.
Receba e chame
Verifique a assinatura HMAC-SHA256 de cada evento e chame a API REST documentada em OpenAPI 3.1.
Requisitos
- Plano
- Gratuito. Todas as integrações estão incluídas em todas as contas Planitude.
- Quem a pode ligar
- Cada utilizador, com a própria chave de API. Webhooks de um projeto: proprietário ou editor; webhooks do espaço de trabalho: proprietário ou administrador.
- O que é necessário
- Um endpoint HTTPS público para receber os webhooks; para a API, uma chave criada em Perfil → Chaves de API.
A saber
- Zapier, Make e n8n chegam em breve e vão usar esta mesma API e estes webhooks.
- As chaves e as apps ligadas não podem apagar projetos nem tarefas: apagar continua a ser feito na app web.
Guias e documentação
Documentação
Webhooks: eventos, assinaturas e novas tentativas
Catálogo de eventos, verificação da assinatura HMAC-SHA256 e entrega com novas tentativas.
Guia
As ferramentas a ligar ao Planitude: guia de integrações
Integrações do Planitude: Jira, Azure DevOps, Slack, Teams, calendários, ChatGPT, Claude e Gemini via MCP, API e webhooks, ficheiros .mpp e .xer. Qual escolher.
Perguntas frequentes sobre API REST
Como verifico que um webhook vem mesmo do Planitude?
Cada pedido traz um cabeçalho com um carimbo temporal e a assinatura HMAC-SHA256 do corpo: volte a calculá-la com o segredo do webhook e rejeite os pedidos demasiado antigos. A documentação para programadores tem exemplos prontos a usar.
Uma integração por API pode eliminar projetos?
Não. As chaves de API e as apps ligadas podem ler e, com permissão de escrita, criar e atualizar, mas a eliminação de projetos e tarefas fica na app web.
As integrações têm custo?
Não. Todas as integrações estão incluídas no Planitude, que é gratuito. Só precisa do seu próprio acesso à outra ferramenta (por exemplo, uma conta do Jira, do Slack ou do Microsoft 365), nas condições dessa ferramenta.
Como se desliga uma integração?
Na página da app no projeto, com Desligar, a qualquer momento. Nada é apagado: as tarefas ficam no Planitude, as issues e as mensagens ficam na outra ferramenta. As apps de IA ligadas revogam-se em Perfil → Chaves de API.
As marcas mencionadas (Jira, Azure DevOps, Slack, Microsoft Teams, Microsoft Outlook, Microsoft PowerPoint, Microsoft Project, Visual Studio Code, Google Calendar, Gemini, Apple Calendar, ChatGPT, Codex, Claude, Cursor, Zapier, Make, n8n, Primavera) pertencem aos respetivos titulares; o Planitude não é afiliado a eles nem aprovado por eles.