批量编辑短链

吕遥

发布于 2024-12-04 11:44:58

接口功能

批量传入数据，可以批量修改短链接的跳转地址、名称等信息。

接口地址

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

请求方法

POST

请求参数说明

参数名	类型	是否必传	描述
apikey	string	是	团队的API密钥
link_items	array<object>	是	短链参数列表，数量不超过100
link_url	string	是	短链地址
target_url	string	否	跳转的目标链接，必须是以 http:// 或 https:// 开头的链接或者应用跳转链接
name	string	否	短链名称，长度不超过128个字符
advanced_bot_detection	boolean	否	是否开启深度过滤机器访问
webhook	boolean	否	是否开启事件推送
webhook_scene	string	否	事件推送场景值，会包含在每次推送的数据中，可填写任意参数值，长度不超过128个字符

JSON请求示例

{
    "apikey": "5ac55544645cf99e40b14b4e78de5d90",
    "link_items": [
        {
            "link_url": "https://s.xma.im/U4wsNm",
            "target_url": "https://xiaomark.com/shortlink",
            "advanced_bot_detection": false
        },
        {
            "link_url": "https://s.xma.im/SA4bj7",
            "target_url": "https://docsmall.com/image-compress",
            "name": "图片压缩",
            "webhook": true,
            "webhook_scene": "image-compress"
        },
        {
            "link_url": "https://s.xma.im/8jLuaC",
            "advanced_bot_detection": true,
            "webhook": false
        }
    ]
}

返回数据说明

字段名	类型	描述
code	integer	返回码，0 代表请求成功，其他数值代表出错，详细见“返回码说明”页面
message	string	“请求成功”，或者相应的错误信息

JSON返回示例

{
    "code": 0,
    "message": "请求成功",
    "data": {}
}