diff --git a/app/templates/views/api/documentation.html b/app/templates/views/api/documentation.html index 29eeda48e..f59f58168 100644 --- a/app/templates/views/api/documentation.html +++ b/app/templates/views/api/documentation.html @@ -26,6 +26,7 @@ {{ name }} {% endfor %} +
- Service teams should do all their testing within the GOV.UK Notify production environment (https://api.notifications.service.gov.uk). + Service teams should do all their testing within the GOV.UK Notify production environment, https://api.notifications.service.gov.uk.
- You don’t need different Notify accounts or access to other Notify environments. Instead, there are different types of API key that let you do functional or performance integration testing. + You don’t need different Notify accounts or access to other Notify environments. Instead, there are different types of API keys that let you do functional or performance integration testing.
-- The 3 types of API key that you can create within GOV.UK Notify are: + There are 3 types of API key available within GOV.UK Notify:
- You should plan to rotate these keys on a regular basis. You may have more than one active key at a time. To revoke the key simply click the revoke button on the API Key page. + You should plan to rotate these keys on a regular basis. You may have more than one active key at a time. To revoke the key click the revoke button on the API Key page.
- A team key lets you send real messages to members of your team (and addresses/numbers that you have added to your whitelist). You will get an error if you use these keys to send messages to anyone else. + A team key lets you send real messages to members of your team and addresses/numbers that you have added to your whitelist. You will get an error if you use these keys to send messages to anyone else.
Messages sent with a team key show up on your dashboard and count against your text message and email allowances. @@ -54,7 +54,7 @@ Use a test key to test the performance of your service and its integration with GOV.UK Notify under load.
- A test key doesn’t send real messages but generates realistic responses. There’s no restriction on who you can send to or how many messages you can send per day. + Test keys don’t send real messages but do generates realistic responses. There’s no restriction on who you can send to or how many messages you can send per day.
Messages sent using a test key don’t show up on your dashboard or count against your text message and email allowances. @@ -70,6 +70,28 @@
+ If you need to smoke test your integration with Notify on a regular basis, you should use the smoke test numbers and addresses below. +
++ The smoke test numbers and addresses will immediately return a successful response, but won’t send a real message and won’t produce a delivery receipt. +
++ You can use the smoke test numbers and addresses with any type of key. +
++ If your smoke tests need to fetch a delivery receipt, then use a test key - and don’t use these numbers and addresses. + +