{% from "components/table.html" import mapping_table, row, text_field, edit_field, field %} {% extends "withoutnav_template.html" %} {% block per_page_title %} Integration testing {% endblock %} {% block maincolumn_content %}
There are different types of API keys that let you do functional or performance integration testing. You don’t need different GOV.UK Notify accounts or access to other GOV.UK Notify environments.
Once your service is live you are able to create Live keys. You can then use these keys to send messages to anyone.
Messages sent with a live key show up on your dashboard and count against your text message and email allowances.
You should revoke and re-create these keys on a regular basis. You can have more than one active key at a time. To revoke a key click the revoke button on the API Key page.
Use a team and whitelist key for end-to-end functional testing.
A team and whitelist 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 and whitelist key show up on your dashboard and count against your text message and email allowances.
Use a test key to test the performance of your service and its integration with GOV.UK Notify.
Test keys don’t send real messages but do generates realistic responses. There’s no restriction on who you can send to.
Messages sent using a test key don’t show up on your dashboard or count against your text message and email allowances.
By default, all messages sent with a test key will result in a delivered status.
If you want to test failure responses with a test key, use the following numbers and addresses:
If you need to smoke test your integration with GOV.UK 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. The notification ID is not a real ID, you will not be able to fetch the notification by ID.
You can use the smoke test numbers and addresses with any type of key. If your smoke tests need to get the status of a message, then use a test key and don’t use these numbers and addresses.