---
title: "API REST para ler e escrever os planos"
description: "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."
url: https://planitude.app/pt/integrations/api
language: pt
---

# 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 · Automatização e programadores

## 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.

### O que passa e em que direçã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

**Nas duas direções**

- Projetos, tarefas, atribuições e dependências ↔ Leitura e escrita via API REST

## Como se liga, em três passos

1. **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.
2. **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.
3. **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

- [API REST: guia rápido e referência](https://planitude.app/pt/developers#quickstart): Autenticação com chave de API, limites de frequência, paginação e referência OpenAPI 3.1.
- [Webhooks: eventos, assinaturas e novas tentativas](https://planitude.app/pt/developers#webhooks): Catálogo de eventos, verificação da assinatura HMAC-SHA256 e entrega com novas tentativas.
- [As ferramentas a ligar ao Planitude: guia de integrações](https://planitude.app/pt/blog/planitude-integrations-guide): 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.

## Integrações relacionadas

- [Webhooks](https://planitude.app/pt/integrations/webhooks): Eventos HTTPS assinados a cada alteração num projeto.
- [Zapier](https://planitude.app/pt/integrations/zapier): Acionadores e ações para milhares de aplicações.
- [Make](https://planitude.app/pt/integrations/make): Cenários com módulos do Planitude e acionadores instantâneos.
- [n8n](https://planitude.app/pt/integrations/n8n): Nó da comunidade, também para n8n alojado por si.

## Ligue API REST ao Planitude

Crie uma conta gratuita, abra um projeto e escolha Integrações no menu ⋯. Bastam dois minutos.

[Criar conta gratuita](https://planitude.app/pt/signup)

*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.*