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

吕遥

发布于 2024-12-04 00:00:06

接口功能

批量创建原始链接不同的短链接。

接口地址

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

请求方法

POST

请求参数说明

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

JSON请求示例

{
    "apikey": "5ac55544645cf99e40b14b4e78de5d90",
    "group_id": "81myhfrn",
    "link_items": [
        {
            "target_url": "https://xiaomark.com/shortlink",
            "advanced_bot_detection": true
        },
        {
            "target_url": "https://docsmall.com/image-compress",
            "name": "图片压缩",
            "webhook": true,
            "webhook_scene": "image-compress"
        },
        {
            "target_url": "https://portal.xiaomark.com/rule.html",
            "name": "使用规范",
            "advanced_bot_detection": true,
            "webhook": true,
            "webhook_scene": "rule"
        }
    ],
    "domain": "s.xma.im"
}

返回数据说明

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

JSON返回示例

{
    "code": 0,
    "message": "请求成功",
    "data": {
        "link_url_list": [
            "https://s.xma.im/xujsub",
            "https://s.xma.im/yCsbUa",
            "https://s.xma.im/aXmLsQ"
        ],
        "count": 3
    }
}