Digital messages for a UK tax customer that has opted-in to paperless communications
The following services are exposed from the micro-service.
Please note it is mandatory to supply an Accept HTTP header to all below services with the value application/vnd.hmrc.1.0+json
.
- Run locally:
sbt run
which runs on port8234
by default - Run with test endpoints:
sbt 'run -Dplay.http.router=testOnlyDoNotUseInAppConf.Routes'
The service can be run locally from Service Manager, using the following profiles:
Profile Details | Command |
---|---|
MOBILE_MESSAGES_ALL | sm2 --start MOBILE_MESSAGES_ALL --appendArgs '{"SECURE_MESSAGE": ["-Dplay.http.router=testOnlyDoNotUseInAppConf.Routes"]}' |
- Run Unit Tests:
sbt test
- Run Integration Tests:
sbt it:test
- Run Unit and Integration Tests:
sbt test it:test
- Run Unit and Integration Tests with coverage report:
sbt clean compile coverage test it:test coverageReport dependencyUpdates
Task | Supported Methods | Description |
---|---|---|
/messages |
GET | Returns all the user's digital messages. More... |
/messages/read |
POST | Returns a specific user message as an HTML partial. More... |
/messages/count |
GET | Returns a count of all the user's digital messages. More... |
All the above endpoints are accessible on sandbox with /sandbox
prefix on each endpoint, e.g.
GET /sandbox/messages
To trigger the sandbox endpoints locally, use the "X-MOBILE-USER-ID" header with one of the following values: 208606423740 or 167927702220
To test different scenarios, add a header "SANDBOX-CONTROL" to specify the appropriate status code and return payload. See each linked file for details:
Task | Supported Methods | Description |
---|---|---|
/messages |
GET | Acts as a stub for the related live endpoint. More... |
/read-message |
POST | Acts as a stub for the related live endpoint. More... |
/read-message |
GET | Acts as a stub for the related live endpoint. More... |
Version of API need to be provided in Accept
request header
Accept: application/vnd.hmrc.v1.0+json
This code is open source software licensed under the Apache 2.0 License.