Platform of Trust Platform Design Guide
Developer PortalAPI DocsOntology
  • Purpose and scope
  • Developer eXperience Strategy
  • Suggest changes
  • API Requests
    • Request validation
    • Response codes used
    • Error handling
  • General API guidelines
    • Performance
    • Documentation
    • Data models used
    • Use HATEOAS
    • Use HTTP Methods
    • Dates and time
    • Naming conventions
    • Pagination, partial response and sorting
    • API Testing
  • API Headers
    • Mandatory elements & behaviour
    • Rate limiting information
  • API Security
    • Authentication and authorization
    • SSL everywhere - all the time
  • API versioning guidelines
    • Versioning Rules
    • Breaking changes
    • Non-breaking changes example
    • Retirement process
    • Add new API to documentation
    • Add new endpoint
  • API Migration Policies
    • Deprecating API
    • Sunsetting API
    • Blackout Testing
    • Migration Email Template
    • API Blackout Test Email Template
    • API Deprecation Email
    • Deprecating an older API
  • Ontologies
    • About ontologies
    • Web Ontology Language, OWL
    • Ontology editor
    • Edit ontology
    • Add new subclass
    • Naming convention logic
    • Extending the ontology
  • Design Guideline
    • Colors
    • Typography
    • Grids and Space
    • Input forms - Text field
    • Input forms - Text area
    • Buttons
    • Checkbox
    • Radio buttons
    • Date picker
    • Form control - Single select
    • Toggle
    • Pagination
    • Status pills
    • Tables
    • Effects
    • Dialogues
Powered by GitBook
On this page

Was this helpful?

  1. API Migration Policies

Deprecating API

PreviousAdd new endpointNextSunsetting API

Last updated 4 years ago

Was this helpful?

We are constantly evolving our APIs and their features. At some point of time when the new version of the API is ready to be published, we will initiate the retirement process for the current version of the API.

Our retirement process can be divided into two stages:

  1. Deprecating API meaning its not recommended or preferred version anymore

  2. Sunsetting API meaning it will cease to exist after the sunset period expires

This topic is related to the first stage. Deprecated APIs will no longer be supported or recommended to use, however API still remains operational and can be used. New version of the API should be adopted. We decided not to deprecate APIs partially by parameters or by individual resources, instead, we will be deprecating entire API.

Informing Customers

We are going to inform customers whenever we are launching a new version of the API and deprecating the current version.

Announcement Email

Customers will receive deprecation related email announcing the intended deprecation, with the proposed deprecation time, next version release schedule and additional information such as support and contact information, etc.

Announcements in Social Media

We will make official announcements related to deprecation and its process on the company's and on Twitter .

In addition, we encourage all developers to ask Platform of Trust related questions in . Retirement process is no exception. To be able to track new questions easily our developer team managed to pull some strings and have platform-of-trust tag created on Stack Overflow.

Documentation

We keep our API documentation up to date. You will find additional information about deprecated APIs and their endpoints from here.

Technical Communication

API responses will include Deprecation header with the date when API is or will be deprecated and the link to the additional information related to that process.

Example:

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"

Sunsetting

After the API has been deprecated, at some point of time we will move to stage two, sunsetting deprecated API, meaning it will become unresponsive. Please read more about sunsetting .

website
@PlatformOfTrust
Stack Overflow
here