Creating a Message Template¶
Description¶
API name
CreateMessageTemplate
Function
Create a message template for quick message sending to reduce the request data volume.
By default, a user can create a maximum of 100 message templates. However, in a high-concurrency scenario, which is rare, extra templates may be successfully created.
URI¶
URI format
POST /v2/{project_id}/notifications/message_template
Parameter description
Parameter
Mandatory
Type
Description
project_id
Yes
String
Project ID
Request¶
Parameter description
Parameter
Mandatory
Type
Description
message_template_name
Yes
String
Template name
The template name is a string of 1 to 64 characters. It must contain upper- or lower-case letters, digits, hyphens (-), and underscores (_), and must start with a letter or digit.
content
Yes
String
Template content, which currently supports plain text only
The template content cannot be left blank or larger than 256 KB.
protocol
No
String
Protocol supported by the template
Currently, the following protocols are supported:
email
default
sms
dms
http and https
Example request
POST https://{SMN_Endpoint}/v2/{project_id}/notifications/message_template{ "message_template_name": "confirm_message", "protocol": "https", "content": "(1/2)You are invited to subscribe to topic({topic_id}). Click the following URL to confirm subscription:(If you do not want to subscribe to this topic, ignore this message.)" }
Response¶
Parameter description
Parameter
Type
Description
request_id
String
Request ID, which is unique
message_template_id
String
Resource identifier of the template, which is unique
Example response
{ "request_id":"ca03efa691624d8eb2dfeba01a1bcf6e", "message_template_id":"57ba8dcecda844878c5dd5815b65d10f" }
Returned Value¶
See section Returned Value.
Error Code¶
See section Error Code.