Het volgende artikel biedt aanvullende informatie over de finale migratie naar onze huidige API-versie, die in dit artikel 'API v2' wordt genoemd. Deze informatie is vooral relevant voor klanten die nog oudere integraties gebruiken die gebruikmaken van de vorige API-versie, hier 'API v1' genoemd.
Context
Een paar jaar geleden introduceerden we API v2, een robuuste en geavanceerde versie van onze vorige API, ontworpen om je integratiemogelijkheden met Teamleader Focus te verbeteren. Sinds de introductie van API v2 is API v1 niet meer publiekelijk beschikbaar. Echter, om oudere integraties te ondersteunen, bleven we het gebruik van API v1 toestaan totdat API v2 dezelfde functionaliteiten bevatte.
We zijn blij te kunnen aankondigen dat API v2 op het punt staat API v1 volledig te vervangen. Ons toegewijde ontwikkelingsteam heeft actief gewerkt aan het aanpakken van eventuele beperkingen, om ervoor te zorgen dat API v2 dezelfde functionaliteiten biedt als zijn voorganger.
Beëindigen van API v1: 1 augustus 2024
Om onze services te stroomlijnen en een consistente integratie-ervaring te behouden, stoppen we op 1 augustus 2024 met API v1. Deze beslissing is bedoeld om ervoor te zorgen dat alle integraties kunnen profiteren van de verbeterde mogelijkheden van API v2.
Opmerking: op 1 juni 2024 gaan we over op een Alleen-lezen modus, waarbij je alleen gegevens kan ophalen via API v1, in plaats van bestaande gegevens toe te voegen, te verwijderen of bij te werken.
Welke acties kan je ondernemen?
Als je nog steeds API v1-functionaliteit gebruikt, zullen de admingebruikers van je account meerdere meldingen van ons ontvangen tussen oktober 2023 en augustus 2024. De meerderheid van de API v1-gebruikers kan al overstappen op API v2 zonder functionaliteit te verliezen. Anderen zullen moeten wachten tot de ontbrekende endpoints zijn ontwikkeld (naar verwachting uiterlijk februari 2024).
Hier zijn de stappen die je kan nemen om je voor te bereiden op de migratie naar API v2:
Breng je ontwikkelaar op de hoogte:
Als je een externe integrator of een team hebt dat je Teamleader Focus-integratie beheert en je hebt een e-mail van ons ontvangen, informeer hen dan over deze update. Het is cruciaal dat zij op de hoogte zijn van deze veranderingen voor een soepele overgang.
Voorbereiden op de overgang:
We raden je aan om API v2 onmiddellijk te verkennen. Je kan de bijbehorende documentatie hier vinden.
Blijf op de hoogte:
Kijk voor de laatste updates over specifieke endpoints en functionaliteiten regelmatig op onze API v2-Roadmap. We zullen deze blijven bijwerken als er nieuwe endpoints worden toegevoegd. In februari 2024 zouden de laatste endpoints ontwikkeld moeten zijn.
We zijn er om te helpen
We begrijpen dat dit alles complex kan zijn. Ons technische supportteam is er om je tijdens dit proces te helpen. Als je begeleiding nodig hebt of als je je zorgen maakt, neem dan gerust contact met ons op. Jouw tevredenheid is onze topprioriteit en we doen er alles aan om deze overgang voor jou zo naadloos mogelijk te laten verlopen.