Querying Message Templates

Description

API name
ListMessageTemplates

Function
Query the template list by page. The list is sorted by the template creation time in ascending order. You can specify offset and limit. If no template has been created, an empty list is returned. The parameters message_template_name and protocol are added.

The template list provides only brief information. To query the template details, see Querying the Details of a Message Template.

URI

URI format
GET /v2/{project_id}/notifications/message_template?offset={offset}&limit={limit}&message_template_name={message_template_name}&protocol={protocol}

Parameter description

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID See Obtaining a Project ID.
offset	No	Integer	Offset If the offset is an integer greater than 0 but less than the number of resources, all resources after this offset will be queried. The default offset is 0.
limit	No	Integer	Number of resources returned on each page Value range: 1–100 Commonly used numbers are 10, 20, and 50. The default number is 100.
message_template_name	No	String	Template name Enter 1 to 64 characters, and start with a letter or digit. Only letters, digits, hyphens (-), and underscores (_) are allowed.
protocol	No	String	Protocol supported by the template The following protocols are supported: email default sms http and https

Request

Example request

GET https://{SMN_Endpoint}/v2/{project_id}/notifications/message_template?offset=0&limit=2&message_template_name=test1&protocol=email

Response

Parameter description

Parameter	Type	Description
request_id	String	Request ID, which is unique
message_template_count	String	Number of returned templates
message_templates	Array of Table 1 objects	Message_template structure array

**Table 1** Message template structure
Parameter	Type	Description
message_template_id	String	Template ID
message_template_name	String	Template name
protocol	String	Protocol supported by the template The following protocols are supported: email default sms http and https
tag_names	String array	Variable list
create_time	String	Time when the template was created The UTC time is in YYYY-MM-DDTHH:MM:SSZ format.
update_time	String	Last time when the template was updated The UTC time is in YYYY-MM-DDTHH:MM:SSZ format.

Example response

{
    "message_templates":[
        {
            "message_template_name": "confirm_message",
            "update_time": "2016-08-02T08:22:18Z",
            "create_time": "2016-08-02T08:22:18Z",
            "tag_names":[
                "topic_urn"
            ],
            "message_template_id": "79227dfdf88d4e52a1820ca1eb411635"
        },
        {
            "message_template_name": "confirm_message",
            "protocol": "email",
            "update_time": "2016-08-02T08:22:19Z",
            "create_time": "2016-08-02T08:22:19Z",
            "tag_names": [
                "topic_id"
            ],
            "message_template_id": "ecf63465804a4b10a0573980be78ffba"
        },
        {
            "message_template_name": "confirm_message",
            "protocol": "https",
            "update_time": "2016-08-02T08:22:20Z",
            "create_time": "2016-08-02T08:22:20Z",
            "tag_names": [
                "topic_id"
            ],
            "message_template_id": "57ba8dcecda844878c5dd5815b65d10f"
        }
    ],
    "request_id": "ce7f2f7343224f8c9597b05a9a0bcc2e",
    "message_template_count": 3
}