Documentatie
REST-API: snelstart en naslag
Authenticatie met een API-sleutel, rate limits, paginering en de OpenAPI 3.1-naslag.
Automatisering en ontwikkelaars
REST-API om planningen te lezen en te schrijven
Projecten, taken, toewijzingen en afhankelijkheden via een REST-API, met API-sleutels met beperkte rechten en OpenAPI 3.1-naslag.
- Beschikbaar
- Gratis, inbegrepen in elk account
Wat het doet
Webhooks en REST-API voor je eigen automatiseringen
Voor alles zonder kant-en-klare integratie: een ondertekende gebeurtenis zodra er iets verandert, en een API om de planning te lezen en te schrijven.
Waarvoor het dient
- Planitude koppelen aan een intern systeem, een ERP of een datawarehouse.
- Een automatisering starten zodra een taak is afgerond of verplaatst.
- Projecten en taken aanmaken vanuit een andere tool, zonder ze over te typen.
Van Planitude naar Jouw systeem
- Elke wijziging, of die nu uit de webapp, de API, MCP of een import komt → Ondertekende gebeurtenissen, Van Planitude naar Jouw systeem
In beide richtingen
- Projecten, taken, toewijzingen en afhankelijkheden ↔ Lezen en schrijven via de REST-API, In beide richtingen
Instellen
In drie stappen gekoppeld
Maak een API-sleutel
In Profiel → API-sleutels, alleen lezen of lezen en schrijven, eventueel beperkt tot één werkruimte en met een vervaldatum.
Registreer een webhook
Op één project of een hele werkruimte, met een keuze uit 14 gebeurtenissen: taken aangemaakt, afgerond of verschoven, afhankelijkheden, basisplanningen, opmerkingen en meer.
Ontvang en roep aan
Controleer de HMAC-SHA256-handtekening van elke gebeurtenis en roep de REST-API aan die in OpenAPI 3.1 is beschreven.
Vereisten
- Abonnement
- Gratis. Alle integraties zijn inbegrepen in elk Planitude-account.
- Wie kan koppelen
- Iedere gebruiker, met de eigen API-sleutel. Projectwebhooks: eigenaar of bewerker; werkruimtewebhooks: eigenaar of beheerder.
- Wat je nodig hebt
- Een openbaar HTTPS-endpoint om webhooks te ontvangen; voor de API een sleutel uit Profiel → API-sleutels.
Goed om te weten
- Zapier, Make en n8n komen binnenkort en gebruiken precies deze API en deze webhooks.
- Sleutels en gekoppelde apps kunnen geen projecten of taken verwijderen: verwijderen kan alleen in de webapp.
Handleidingen en documentatie
Documentatie
Webhooks: gebeurtenissen, handtekeningen en nieuwe pogingen
Overzicht van gebeurtenissen, controle van de HMAC-SHA256-handtekening en aflevering met nieuwe pogingen.
Handleiding
De tools die je aan Planitude koppelt: gids voor integraties
Integraties van Planitude: Jira, Azure DevOps, Slack, Teams, agenda’s, ChatGPT, Claude en Gemini via MCP, API en webhooks, .mpp- en .xer-bestanden. Wat te kiezen.
Veelgestelde vragen over REST-API
Hoe controleer ik of een webhook echt van Planitude komt?
Elk verzoek bevat een header met een tijdstempel en de HMAC-SHA256-handtekening van de inhoud: bereken die opnieuw met het webhookgeheim en weiger verzoeken die te oud zijn. De documentatie voor ontwikkelaars bevat kant-en-klare voorbeelden.
Kan een API-integratie projecten verwijderen?
Nee. API-sleutels en gekoppelde apps kunnen lezen en, met schrijfrechten, aanmaken en bijwerken, maar het verwijderen van projecten en taken blijft voorbehouden aan de webapp.
Kosten de integraties iets?
Nee. Alle integraties zitten in Planitude, en Planitude is gratis. Je hebt alleen je eigen toegang tot de andere tool nodig (bijvoorbeeld een Jira-, Slack- of Microsoft 365-account), op de voorwaarden van die tool.
Hoe ontkoppel ik een integratie?
Op elk moment via de pagina van de app in het project, met Ontkoppelen. Er wordt niets verwijderd: taken blijven in Planitude, issues en berichten blijven in de andere tool. Gekoppelde AI-apps trek je in via Profiel → API-sleutels.
De genoemde merken (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) zijn eigendom van hun respectieve eigenaren; Planitude is niet aan hen gelieerd en wordt niet door hen onderschreven.