批量创建短链（原始链接相同）

吕遥

发布于 2024-12-03 23:59:46

接口功能

此接口可以批量创建生成短链接，并且所有的短链接跳转到相同的原始链接。

接口地址

https://api.xiaomark.com/v2/sl/link/batch_duplicate

请求方法

POST

请求参数说明

参数名	类型	是否必传	描述
apikey	string	是	团队的API密钥
group_id	string	是	分组id
amount	integer	是	要创建的短链数量，不超过1000条
target_url	string	是	跳转的目标链接，必须是以 http:// 或 https:// 开头的链接或者应用跳转链接
domain	string	否	自有域名，不填则默认使用 sourl.cn；使用自有域名可以生成任意域名下的短链，无需设置白名单
key_length	integer	否	使用自有域名生成短链可以自定义随机后缀的长度，最小为4，最大为8，默认为6
advanced_bot_detection	boolean	否	是否开启深度过滤机器访问，默认不开启
webhook	boolean	否	是否开启事件推送，默认不开启
webhook_scene	string	否	事件推送场景值，会包含在每次推送的数据中，可填写任意参数值，长度不超过128个字符

JSON请求示例

{
    "apikey": "5ac55544645cf99e40b14b4e78de5d90",
    "group_id": "81myhfrn",
    "amount": 10,
    "target_url": "https://xiaomark.com/shortlink",
    "advanced_bot_detection": true,
    "webhook": true,
    "webhook_scene": "xiaomark"
}

返回数据说明

字段名	类型	描述
code	integer	返回码，0 代表请求成功，其他数值代表出错，详细见“返回码说明”页面
message	string	“请求成功”，或者相应的错误信息
data	object	请求成功返回的数据
link_url_list	array<string>	短链地址列表
count	integer	创建的短链数量

JSON返回示例

{
    "code": 0,
    "message": "请求成功",
    "data": {
        "link_url_list": [
            "https://sourl.cn/xNHtLT",
            "https://sourl.cn/GcZVyc",
            "https://sourl.cn/RK9nAh",
            "https://sourl.cn/zvzHi5",
            "https://sourl.cn/SbimsX",
            "https://sourl.cn/WPqMbz",
            "https://sourl.cn/qtXPmM",
            "https://sourl.cn/uaH3Rm",
            "https://sourl.cn/yS8uKe",
            "https://sourl.cn/LvcqhK"
        ],
        "count": 10
    }
}