Als jou bedrijf een software integratie heeft om data van T Comm Telematics in andere software pakketten uit te lezen is dit bericht belangrijk voor je. Dit artikel bevat uitgebreide details over de API End Of Life. Deze wijzigingen hebben gevolgen voor de eindgebruiker en voor de functionaliteit. Stel indien nodig de juiste personen hiervan op de hoogte.
LEGACY API
Data integriteit en security staat hoog in het vaandel bij T Comm Telematics. Om dit te kunnen blijven waarborgen zijn constante ontwikkelingen naar modernere oplossingen nodig. Zo ook voor het beschikbaar stellen van data via onze API.
Sinds medio 2015 stelde T Comm Telematics data beschikbaar via de oude API. Om de data veiligheid en integriteit te kunnen blijven waarborgen heeft T Comm Telematics sinds 2018 naast de oude API een moderne REST API beschikbaar gesteld met uitgebreide mogelijkheden en hoge graad van beveiliging.
Het moment is aangebroken om de ondersteuning van de oude API te beëindigen op 1 november 2020. Vanaf dit moment zal de oude API gedeactiveerd worden waardoor er geen data meer verkrijgbaar is via deze weg.
Wat gebeurt er en wanneer?
Om klanten in staat te stellen gebruik te maken van een uniform platform voor verrijkte, controleerbare data, concentreert T Comm Telematics zijn inspanningen op de nieuwe en verbeterde REST API (api.tcommtelematics.com/v1/ … endpoint) en zal de Legacy API (portal .tcommtelematics.com endpoint) op 1 november 2020 gedeactiveerd worden. Na deze datum accepteert T Comm Telematics geen Legacy API-verkeer meer. Alle klanten die toegang hebben tot deze Legacy API werden direct op de hoogte gebracht van dit plan voor einde levensduur, aangezien de toegang op de EOL-datum wordt uitgeschakeld.
Om te kunnen blijven werken, moeten alle applicaties en integraties die de Legacy API gebruiken, vóór de EOL-datum naar de REST API migreren.
Waarom is deze migratie vereist?
Deze wijziging zorgt voor een stabiel en veilig API-gebruik, waardoor het T Comm Telematics-team zich kan concentreren op de REST API die een bredere reeks gebruiksscenario’s beheert en klanten verbeterde functionaliteit biedt.
De REST API is ook verrijkt met nieuwe functies en prestatieverbeteringen, waardoor vrijwel realtime alleen-lezen toegang tot de gegevens van uw organisatie wordt geboden.
Wat is de impact op klanten?
- De Legacy API wordt uitgeschakeld en maakt geen gegevens meer beschikbaar.
- T Comm Telematics accepteert niet langer Legacy API-verkeer, ondersteuningsaanvragen of bugfixes.
- Alle (directe en externe) integraties die afhankelijk zijn van deze API, werken niet meer.
- Klanten hebben geen toegang meer tot gegevens en/of kunnen deze niet meer opvragen.
Hoe lang duurt de migratie naar de Data API?
Klanten moeten de onderstaande details en documentatie vroegtijdig gebruiken om immigratie in te plannen en uit te voeren. De mate van inspanning voor de nieuwe REST API zal per integratie verschillen. De aanpassingen zijn relatief klein maar noodzakelijk om data te kunnen garanderen. Bij benadering zal een programmeur met voldoende kennis van zaken de migratie in enkele uren verspreid over een of meerdere dagen kunnen voltooien.
T Comm Telematics stelt beheerders voor ruim de tijd te besteden aan dit migratieproces om ervoor te zorgen dat alle vereiste integraties correct gegevens uit de REST API halen vóór de EOL-datum.
Hoe kan een klant controleren of hij gebruikmaakt van de Legacy API of de REST API?
Klanten die de nieuwe REST API gebruiken, hebben het volgende volledige pad naar de endpoints ingesteld: https://api.tcommtelematics.com/v1 / … Als dit volledige pad anders is dan dient er een migratie naar de nieuwe REST API plaats te vinden.
Hoe de API-integratie succesvol te migreren?
Maak gebruik van de online documentatie op api.tcommtelematics.com om met succes naar de REST API te migreren. Ondersteuning kan worden aangevraagd bij de T Comm Telematics Servicedesk.
If your company has a software integration to read data from T Comm Telematics in other software packages, this message is important to you. This article provides extensive details about the End of Life API. These changes have consequences for the end user and functionality. If necessary, notify the appropriate persons.
LEGACY API
Data integrity and security are of paramount importance at T Comm Telematics. To be able to continue to guarantee this, constant developments towards more modern solutions are necessary. This also applies to making data available via our API.
Since mid-2015, T Comm Telematics has made data available via the old API. In order to be able to continue to guarantee data security and integrity, T Comm Telematics has made a modern REST API available with extensive options and a high degree of security since 2018, in addition to the old API.
The time has come to end support for the old API on November 1, 2020. From this moment on, the old API will be deactivated, so that no more data will be available via this route.
What is happening and when?
To enable customers to leverage a unified platform for enriched, auditable data, T Comm Telematics is concentrating its efforts on the new and improved REST API (api.tcommtelematics.com/v1/… endpoint ) and will end of life the legacy API (portal.tcommtelematics.com endpoint) on November 1, 2020. After this date, T Comm Telematics will no longer accept Legacy API traffic. All customers who have accessibility to this Legacy API were notified directly of this end of life plan as the access will be disabled on the EOL date.
To continue to operate, all applications and integrations using the Legacy API must migrate to the REST API before the EOL date.
Why is this migration required?
This change ensures stable and secure API usage allowing the T Comm Telematics team to focus on the REST API that manages a wider set of usage scenarios and provides customers with enhanced functionality. The adjustments are relatively small, but necessary to guarantee data.
The REST API is also enriched with new features and performance improvements, providing near real-time read-only access to your organization’s data.
What is the impact to customers?
- The Legacy API will be disabled and will stop making data available.
- T Comm Telematics will no longer accept Legacy API traffic, support cases, or bug fixes.
- All (direct and third-party) integrations depending on this API will no longer function.
- Customers will no longer be able to access and/or retrieve data.
How long will it take to migrate to the Data API?
Customers should leverage details and documentation below early to plan and execute. The level of effort and migration path to the REST API will vary by integration and each integration will need to be migrated. Approximately, a programmer with sufficient knowledge will be able to complete the migration in a few hours spread over one or more days.
T Comm Telematics suggests administrators dedicate ample time to this migration process to ensure all required integrations are properly pulling data from the REST API before the EOL date.
How can a customer verify if they’re leveraging the Legacy API or the REST API?
Customers using the new REST API have set the following path to the endpoints: https: //api.tcommtelematics.com/v1/… If this path is different than a migration to the new one must take place REST API.
How to successfully migrate the API integration?
Leverage the online documentation at api.tcommtelematics.com to successfully migrate to the REST API. Support can be requested at the T Comm Telematics Servicedesk.