Migration Email Template

Sample emails for announcing API Sunset period and upcoming blackout tests. Check and modify necessary dates, URL and other info before sending the email.

Sub: Migration to API V2 - Platform of Trust

Dear valued customer,

Thanks as you continue to use Platform of Trust for generating harmonized data flow.

You are probably aware, that we have released the 2.0 version of Platform of Trust Architecture and as part of it, version 2 (V2) of our API family.

Soon, our V1 APIs will be entering into sunset stage.

sunset period for V1 APIs will start on <yyyy-mm-dd hh:mm timezone>. Domains for the V1 APIs will cease to exist on <yyyy-mm-dd hh:mm timezone>.

After this date, V1 APIs will stop functioning and will become unresponsive.

The sunset period will take approximately 6 months. During this period, V1 APIS will contain a sunset header as part of their response body:

Deprecation: Sat, 1 Aug 2020 23:59:59 GMT 
Link: <https://api-sandbox.oftrust.net/api-name/v2>; rel="deprecation"; type="text/html", 
<https://docs.oftrust.net/api-name/v2>; rel="deprecation"; type="text/html"
Sunset: Sat, 1 Oct 2020 23:59:59 GMT

The date of the Sunset header is the end date for the API when it will cease to exist. After that date API will respond with HTTP status code 410:Gone.

The sunset period is the last call for you to migrate for a new version of the API. To familiarize yourself with the new Architecture and APIs, some actions are required on your part.

New URLs for the V2 APIs are:

sandbox: https://api-sandbox.oftrust.net/api-name/v2 staging: https://api-staging.oftrust.net/api-name/v2 production: https://api.oftrust.net/ api-name/v2 API Documentation: https://docs.oftrust.net/api-name/v2 API Descriptions: https://developer.oftrust.net/apis/api-name

Important! all the new URLs listed above are already up and running, so you can start the migration immediately. As mentioned, ‘oftrust.net/api-name/v1’ will cease functioning on <yyyy-mm-dd hh:mm timezone>. So please be sure to finish the migration before that deadline.

Planned Blackout Tests

As part of the migration process, Platform of Trust will be performing scheduled blackout tests on the V1 APIs.

For minimized impact, the following dates are chosen for the blackout tests. V1 APIs will not be accessible from <hh:mm timezone>, <Day> to <hh:mm timezone>, <Day> for <number of> hours.

  • <yyyy-mm-dd>

  • <yyyy-mm-dd>

  • <yyyy-mm-dd>

Please do not hesitate to contact us if you have questions, concerns, or special requirements from us. We encourage all developers to ask Platform of Trust related questions in StackOverflow, attaching the platform-of-trust tag in it.

Best Regards,

Jaro Lexmond

API Product Owner, API coordination & tech support


+358 40 900 3598


part of Vastuu Group

Notes for the development team

The email template is saved in Mailgun under Sandbox domain. This domain is used for testing purpose. When it is sent to actual customers, the domain notifications.oftrust.net should be seleted from available domain and the template should be added there.

Last updated