Menu

Samenvatting van de Teamwork.com API

Met de Teamwork.com API V3 koppel je projectinformatie naadloos aan je CRM, boekhouding, BI-tooling of communicatieplatform. Elk resource-type uit het platform - projecten, taken, mijlpalen, tijdregistratie, budgetten en offertes - is atomair aanspreekbaar inclusief custom fields, sideloading en sparse fieldsets.
  • Projecten en taken: Volledige CRUD op projecten, tasklists, taken en subtaken inclusief workflows, tags, milestones en custom items.
  • Tijdregistratie en facturatie: Beheer timelogs, timesheets, time-approvals en allocations voor uren-administratie, budgetbewaking en doorbelasting.
  • Budgetten en offertes: Stel projectbudgetten in, ontvang notificaties bij overschrijding en beheer quotes met sections voor klantvoorstellen.
  • CRM- en HR-data: Synchroniseer companies, people, jobroles en skills met je CRM of HR-systeem voor centrale klant- en medewerkerdata.
  • Samenwerking en client-werk: Forms, notebooks, messages, file-comments en task-comments voor gestructureerde communicatie en input vanuit klanten.
  • Realtime events: Webhooks op nagenoeg alle V3-resources, sparse fieldsets en sideloading om bandbreedte en API-calls te beperken.
API Quick Facts REST
  • Authenticatie OAuth2, Basic Auth, Bearer Token
  • Methods DELETE (34)GET (175)POST (52)PATCH (31)PUT (19)
  • Rate limits 150 requests per minuut (Grow-plan en lager); 300 requests per minuut (Scale-plan); rate limit is global voor alle gebruikers binnen een installation
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON, CSV
  • Versionering URL-based

Laatste ontwikkelingen bij de Teamwork.com API

Teamwork.com lanceerde de eerste REST API (V1) rond 2009 als legacy-laag met JSON- en XML-output, maar met inconsistente patronen. V2 werd intern ontwikkeld om de nieuwe web-app te voeden, met betere caching en duidelijkere parameter-naamgeving. V3 is sinds 2020 beschikbaar als standards-first herontwerp dat sparse fieldsets, sideloading van gerelateerde entities en consistente input/output-formaten ondersteunt. Webhooks zijn voor alle V3-resources beschikbaar. Teamwork beveelt nieuwe integraties expliciet aan om V3 te gebruiken; V1 en V2 blijven backward-compatible ondersteund.

API versies

Custom items (BETA)
1 januari 2024

Custom items, custom fields en sections beschikbaar in V3 voor maatwerk-data per project.

Forms API
1 januari 2023

Forms-endpoints toegevoegd voor publieke en interne formulieren met draft-versies en token-toegang.

Webhooks v2 Major release
1 juni 2021

Uitgebreide webhook-events voor V3-resources inclusief delete-payloads en sample-payloads in de developer-portal.

V3 stable Major release
1 januari 2020

Standards-first V3 API met sparse fieldsets, sideloading van gerelateerde entities en consistente input/output-formaten als opvolger van V1 en V2.

V2 internal
1 januari 2017

V2 ontwikkeld om de nieuwe web-app (codenaam TKO) te voeden, met betere caching en consistentere parameters.

V1 launch Major release
1 januari 2009

Eerste REST API met JSON- en XML-output voor projecten, tasklists, taken, milestones en time tracking.