创建标签
POST
https://aa-hub.ddregion.com/api/v1/tag/create
2.如果要创建一个全新的标签组以及标签,则需要通过group_name参数指定新标签组名称,如果填写的groupname已经存在,则会在此标签组下新建标签。
3.如果填写了group_id参数,则group_name参数会被忽略。
4.不支持创建空标签组。
5.标签组内的标签不可同名,如果传入多个同名标签,则只会创建一个。
请求参数
Query 参数
token
string
调用接口凭证
Body 参数application/json
groupId
string
标签组id
groupName
string
标签组名称
tag
array [object {1}]
必需
name
string
新的标签名称
示例
{
"groupId": "string",
"groupName": "string",
"tag": [
{
"name": "string"
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://aa-hub.ddregion.com/api/v1/tag/create?token=' \
--header 'Content-Type: application/json' \
--data-raw '{
"groupId": "string",
"groupName": "string",
"tag": [
{
"name": "string"
}
]
}'
返回响应
🟢200成功
application/json
Body
errcode
integer
返回码
errmsg
string
对返回码的文本描述内容
data
array [object {5}]
必需
id
string
标签组id
name
string
标签组名
createTimestamp
integer
标签组创建时间戳(毫秒)
order
integer
标签组排序的次序值
tags
array [object {4}]
可选
示例
{
"errcode": 0,
"errmsg": "string",
"data": [
{
"id": "string",
"name": "string",
"createTimestamp": 0,
"order": 0,
"tags": [
{
"id": "string",
"name": "string",
"createTimestamp": 0,
"order": 0
}
]
}
]
}