Querying Watermark Templates
Function
This API is used to query one or more custom watermark templates by template ID or page number.
Calling Method
For details, see Calling APIs.
URI
GET /v1/{project_id}/template/watermark
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. For details about how to obtain the project ID, see Obtaining a Project ID. (tag:hc,hk) Project ID. For details about how to obtain the project ID, see [Obtaining a Project ID]. (tag:hcso,g42,cmcc) |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
template_id |
No |
Array of integers |
Watermark template ID. A maximum of 10 template IDs can be queried at a time. |
page |
No |
Integer |
Page number. If task_id is specified, this parameter is invalid. Default value: 0 |
size |
No |
Integer |
Number of records on each page. If template_id is specified, this parameter is invalid. The value ranges from 1 to 100. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
No |
String |
User token The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. |
Authorization |
No |
String |
Authentication information. This parameter is mandatory when AK/SK-based authentication is used. |
X-Project_Id |
No |
String |
Project ID. This parameter is mandatory when AK/SK-based authentication is used. It is same as the project ID in path parameters. |
X-Sdk-Date |
No |
String |
Time when the request is sent. This parameter is mandatory when AK/SK-based authentication is used. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
total |
Integer |
Total number of queried watermark templates |
templates |
Array of WatermarkTemplate objects |
Details about queried watermark templates |
Status code: 403
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code |
error_msg |
String |
Error description |
Example Requests
GET https://{endpoint}/v1/{project_id}/templates/watermark?template_id =2743
Example Responses
Status code: 200
Watermark template queried successfully.
{ "total" : 1, "templates" : [ { "dx" : 0.1, "dy" : 0.1, "referpos" : "TopRight", "timeline_start" : 0, "timeline_duration" : "ToEND", "image_process" : "Original", "width" : 0.1, "height" : 0.1, "base" : "input", "template_id" : 2743, "template_name" : "createWatermarkTemplate1xYcdyUz", "type" : "Image" } ] }
Status code: 403
Failed to query the watermark template.
{ "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter." }
Status Codes
Status Code |
Description |
---|---|
200 |
Watermark template queried successfully. |
403 |
Failed to query the watermark template. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot