12th March 2019
Over the last few months,HMRC have been working to produce a stabilised view of their API design so that you can have confidence in what they are delivering and how the API target state will look. Below is an overview of the API Approach Document, as well as confirmation on the design principles that HMRC are implementing for these APIs and an FAQ.
API Approach Document
CDS 03 API Approach FAQ v1.0 190228 PS provides a high level view of the API target state and a more detailed view of the endpoints within the APIs that make up our target design. Please note that HMRC will also be issuing an updated version of the Digital Scope Document to reflect these updates.
While you will notice that there are a number of endpoints still to be introduced, and a few indicated for deprecation, we have also spent a significant amount of time looking at our strategy for deprecating endpoints and communicating change. This has fed into the design principles which are outlined below.
API Design Principles
HMRC would like to confirm the following design principles that we have implemented based on your feedback and to ensure that there is no impact on development against existing designs:
CDS 03 API Approach v1 2 190311 PC provides responses to some common questions on the API design and endpoints.
Please contact HMRC if you have any queries.
The API Approach Document will also be available on the HMRC Google Drive in the folder 03 Customs Declaration.