Dokumentaatio
Webhookit: tapahtumat, allekirjoitukset ja uudelleenyritykset
Tapahtumaluettelo, HMAC-SHA256-allekirjoituksen varmennus ja toimitus uudelleenyrityksillä.
Automaatio ja kehittäjät
Allekirjoitetut webhookit jokaisesta suunnitelman muutoksesta
Vastaanota allekirjoitettu HTTPS-tapahtuma heti, kun tehtävä luodaan, valmistuu tai siirtyy, yhdessä projektissa tai koko työtilassa.
- Saatavilla
- Ilmainen, sisältyy jokaiseen tiliin
Mitä se tekee
Webhookit ja REST API omiin automaatioihin
Kaikkeen, mihin ei ole valmista integraatiota: allekirjoitettu tapahtuma heti muutoksen sattuessa sekä API suunnitelman lukemiseen ja kirjoittamiseen.
Missä se auttaa
- Yhdistä Planitude sisäiseen järjestelmään, toiminnanohjausjärjestelmään tai tietovarastoon.
- Käynnistä automaatio heti, kun tehtävä valmistuu tai siirtyy.
- Luo projekteja ja tehtäviä toisesta työkalusta kopioimatta niitä käsin.
Planitudesta kohteeseen Järjestelmäsi
- Jokainen muutos verkkosovelluksesta, API:sta, MCP:stä tai tuonnista → Allekirjoitetut tapahtumat, Planitudesta kohteeseen Järjestelmäsi
Molempiin suuntiin
- Projektit, tehtävät, tehtävänannot ja riippuvuudet ↔ Luku ja kirjoitus REST API:n kautta, Molempiin suuntiin
Käyttöönotto
Yhdistä kolmessa vaiheessa
Luo API-avain
Kohdassa Profiili → API-avaimet: vain luku tai luku ja kirjoitus, halutessasi rajattuna yhteen työtilaan ja vanhenemispäivällä.
Rekisteröi webhook
Yhdelle projektille tai koko työtilalle, 14 tapahtuman joukosta: tehtävien luonti, valmistuminen tai siirto, riippuvuudet, perustasot, kommentit ja muuta.
Vastaanota ja kutsu
Tarkista jokaisen tapahtuman HMAC-SHA256-allekirjoitus ja kutsu OpenAPI 3.1 -muodossa dokumentoitua REST API:a.
Vaatimukset
- Paketti
- Ilmainen. Jokainen integraatio sisältyy jokaiseen Planitude-tiliin.
- Kuka voi yhdistää
- Jokainen käyttäjä omalla API-avaimellaan. Projektin webhookit: omistaja tai muokkaaja; työtilan webhookit: omistaja tai ylläpitäjä.
- Mitä tarvitset
- Julkinen HTTPS-päätepiste webhookien vastaanottoon; API:a varten Profiili → API-avaimet -kohdassa luotu avain.
Hyvä tietää
- Zapier, Make ja n8n tulevat pian, ja ne käyttävät samaa API:a ja samoja webhookeja.
- Avaimet ja yhdistetyt sovellukset eivät voi poistaa projekteja tai tehtäviä: poistaminen jää verkkosovellukseen.
Oppaat ja dokumentaatio
Dokumentaatio
REST API: pikaopas ja kuvaus
API-avaimella todennus, kutsurajoitukset, sivutus ja OpenAPI 3.1 -kuvaus.
Opas
Planitudeen yhdistettävät työkalut: opas integraatioihin
Planituden integraatiot: Jira, Azure DevOps, Slack, Teams, kalenterit, ChatGPT, Claude ja Gemini MCP:llä, API ja webhookit, .mpp- ja .xer-tiedostot. Mitä valita.
Usein kysytyt kysymykset: Webhookit
Miten varmistan, että webhook todella tulee Planitudesta?
Jokaisessa pyynnössä on otsake, jossa on aikaleima ja rungon HMAC-SHA256-allekirjoitus: laske se uudelleen webhookin salaisuudella ja hylkää liian vanhat pyynnöt. Kehittäjädokumentaatiossa on valmiita esimerkkejä.
Voiko API-integraatio poistaa projekteja?
Ei. API-avaimet ja yhdistetyt sovellukset voivat lukea ja kirjoitusoikeudella luoda ja päivittää, mutta projektien ja tehtävien poistaminen jää verkkosovellukseen.
Maksavatko integraatiot jotain?
Ei. Jokainen integraatio sisältyy Planitudeen, joka on ilmainen. Tarvitset vain oman käyttöoikeutesi toiseen työkaluun (esimerkiksi Jira-, Slack- tai Microsoft 365 -tilin) sen omien ehtojen mukaisesti.
Miten katkaisen integraation?
Sovelluksen sivulta projektissa, Katkaise yhteys -painikkeella, milloin tahansa. Mitään ei poisteta: tehtävät jäävät Planitudeen, tiketit ja viestit toiseen työkaluun. Yhdistetyt tekoälysovellukset peruutetaan kohdassa Profiili → API-avaimet.
Mainitut tavaramerkit (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) kuuluvat omistajilleen; Planitude ei ole niihin sidoksissa eivätkä ne suosittele sitä.