Search loading...

API Hub

Explore and Make use of Nationally Defined Messaging APIs

 

API Testing

Guidance for testing against the DoS APIs

Use a Case ID of ‘TEST’ when sending test requests into the APIs

When making API requests for non-live purposes (i.e. not for actual delivery of healthcare services) you must use a test ID in your request.

The Case ID must be set to TEST

e.g. in the path for the JSON / POC API:

https://uat.directoryofservices.nhs.uk/app/controllers/api/v1.0/byServiceType/TEST/../../../../../..

e.g. in the payload for the SOAP API / Web Service:

<web:c>
    <!--Optional:-->
    <web:caseRef>eaf74b1f-bf83-443c-9cce-3a438fd1d2ce</web:caseRef>
    <web:caseId>TEST</web:caseId>
    <web:postcode>LS177NZ</web:postcode>
    <web:surgery>L81043</web:surgery>
    <web:age>1</web:age>
    <web:ageFormat>AgeGroup</web:ageFormat>
    <web:disposition>1132</web:disposition>
    <web:symptomGroup>1206</web:symptomGroup>
    <web:symptomDiscriminatorList>
    <web:int>4193</web:int>
    </web:symptomDiscriminatorList>
    <web:searchDistance>25</web:searchDistance>
    <web:gender>M</web:gender>
</web:c>
  • For SOAP requests, you should not include the CaseRef element unless essential within the context of the testing you are performing.
Tags:

All content is available under the Open Government Licence v3.0, except where otherwise stated