Menu

Samenvatting van de Planview ProjectPlace API

Planview is een ecosysteem met meerdere afzonderlijke producten en API's (AdaptiveWork, AgilePlace, Portfolios, ProjectPlace). Onderstaande functionaliteit beschrijft de REST API van Planview ProjectPlace, het meest publiek gedocumenteerde onderdeel. Daarmee automatiseer je het volledige projectproces: van het aanmaken van workspaces tot het rapporteren van uren, met OAuth 2.0 en speciale robot-accounts voor B2B-integraties.
  • Projecten en accounts: Beheer workspaces, projectsjablonen, leden, rollen, business units en afdelingen vanuit je HR- of ERP-systeem.
  • Kanban en plannen: Muteer boards, kolommen, kaarten, checklists en planlets om voortgang te synchroniseren met externe planningstools.
  • Documenten en mappen: Upload, versioneer en deel documenten via API met een DMS, intranet of e-signing-platform.
  • Tijdregistratie: Haal tijdrapporten per gebruiker, project of activiteit op en push ze door naar je boekhouding.
  • Portfolio en KPI's: Rapporteer KPI-waarden via Monitor-items en bouw realtime portfoliodashboards in je eigen BI-tool.
  • Webhooks: Reageer direct op wijzigingen op boards, kaarten en projecten zonder polling.
API Quick Facts REST
  • Authenticatie OAuth2
  • Methods GET (177)POST (114)PUT (38)DELETE (39)
  • Rate limits Niet gespecificeerd
  • Webhooks Beschikbaar
  • Sandbox Beschikbaar
  • Response format JSON
  • Versionering URL-based
  • SDK's Python, Node.js

Laatste ontwikkelingen bij de Planview ProjectPlace API

ProjectPlace bestaat sinds 1998 en is in 2014 overgenomen door Planview, dat het product sindsdien doorontwikkelt als onderdeel van het bredere portfolio. De REST API is in de loop der jaren stapsgewijs uitgebreid: van OAuth 1 naar OAuth 2.0, met robot-accounts voor B2B-integraties en sandbox-omgevingen voor veilig testen. Per resource zijn nieuwere v2- en v3-endpoints beschikbaar (cards, documents, conversations, notification, user) naast de bestaande v1-routes. Webhooks ondersteunen realtime notificaties bij wijzigingen op boards, kaarten en projecten. Vanaf eind 2017 ondersteunt de API 64-bit IDs.

API versies

64-bit IDs
1 november 2017

ID-velden voor users, projects, cards, planlets en documenten kunnen breder zijn dan 32 bit. Integraties moeten 64-bit integers of strings gebruiken.

v3 conversations Major release

Conversations- en comments-endpoints zijn naar v3 gepromoot, met nieuwe routes per artifact-type voor opmerkingen op kaarten, planlets en documenten.

v2 cards & documents Major release

Voor kaarten en documenten zijn v2-routes geïntroduceerd, waaronder /2/cards/{card_id}/duplicate en uitgebreidere /2/documents-endpoints voor folders, versies en reviews.

OAuth 2.0 + robot-accounts Major release

OAuth 2.0 vervangt OAuth 1 als aanbevolen authenticatiemethode. Robot-accounts maken B2B-integraties mogelijk zonder gebruikersinteractie.

Webhooks Major release

Webhook-platform voor realtime notificaties bij wijzigingen op boards, kaarten en projecten.