mirror of
https://github.com/GSA/notifications-admin.git
synced 2025-12-15 01:23:25 -05:00
Doc tweaks
This commit is contained in:
@@ -36,7 +36,7 @@ To get started:
|
|||||||
|
|
||||||
3. Add a template so you can send sms and email notifications.
|
3. Add a template so you can send sms and email notifications.
|
||||||
|
|
||||||
**Note:** A template is required even if you send notifications by integrating with the GOV.UK Notify API.
|
**Note:** A template is required even if you send notifications with the GOV.UK Notify API.
|
||||||
|
|
||||||
You can personalise the template using double brackets for placeholders. For example:
|
You can personalise the template using double brackets for placeholders. For example:
|
||||||
|
|
||||||
@@ -158,7 +158,7 @@ POST /notifications/email
|
|||||||
|
|
||||||
where:
|
where:
|
||||||
|
|
||||||
* `to` is the phone number (required)
|
* `to` is the phone number or email address (required)
|
||||||
* `template` is the template ID to send (required)
|
* `template` is the template ID to send (required)
|
||||||
|
|
||||||
**Note:** To access the template ID from the [GOV.UK Notify](https://www.notifications.service.gov.uk/) web application, go to **Text message templates** or **Email templates** and click on **API info**.
|
**Note:** To access the template ID from the [GOV.UK Notify](https://www.notifications.service.gov.uk/) web application, go to **Text message templates** or **Email templates** and click on **API info**.
|
||||||
@@ -206,10 +206,11 @@ GET /notifications/{id}
|
|||||||
where:
|
where:
|
||||||
|
|
||||||
* `status` is the the status of the notification; this can be `sending`, `delivered`, or `failed`
|
* `status` is the the status of the notification; this can be `sending`, `delivered`, or `failed`
|
||||||
|
* `to` is the phone number or email address
|
||||||
* `template_type` is `sms` or `email`
|
* `template_type` is `sms` or `email`
|
||||||
* `sent_at` is the full timestamp, in UTC, at which the notification was sent
|
* `sent_at` is the full timestamp, in Coordinated Universal Time (UTC), at which the notification was sent
|
||||||
* `job_id` is the unique identifier for the process of sending and retreiving one or more notifications
|
|
||||||
* `message` is the content of message
|
* `message` is the content of message
|
||||||
|
* `job_id` is the unique identifier for the process of sending and retreiving one or more notifications
|
||||||
* `sender` may be the provider
|
* `sender` may be the provider
|
||||||
|
|
||||||
The above fields are populated once the message has been processed; initially you get back the [response](#coderesponse) indicated above.
|
The above fields are populated once the message has been processed; initially you get back the [response](#coderesponse) indicated above.
|
||||||
@@ -230,7 +231,7 @@ GET /notifications
|
|||||||
'sent_at':'2016-01-01T09:01:00.999999Z',
|
'sent_at':'2016-01-01T09:01:00.999999Z',
|
||||||
'id':1,
|
'id':1,
|
||||||
'message':'...',
|
'message':'...',
|
||||||
'job-id':1,
|
'job_id':1,
|
||||||
'sender':'sms-partner'
|
'sender':'sms-partner'
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
|||||||
Reference in New Issue
Block a user