新建短链

POST

https://www.mxsd.com/openapi/v1/short/common

调用接口需要所属主业务套餐允许调用API。

请求参数

Authorization

API Key

在 header 添加参数

X-API-Key

示例：

X-API-Key: ********************

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "chain_title": "string",
    "channels": [
        {
            "cap": 0,
            "ext": {
                "attribution": true,
                "device": "不限",
                "env": "不限",
                "os": "不限",
                "priority": 0,
                "region_name": "string",
                "regions": [
                    "string"
                ],
                "stat_only": true
            },
            "name": "string",
            "sort": 0,
            "status": 0,
            "target_url": "string",
            "valid_time": 0,
            "weight": 0
        }
    ],
    "code": "string",
    "daily_limit": 0,
    "domain": "s.example.com",
    "filter_rule": {
        "browser": [
            "string"
        ],
        "device": [
            "string"
        ],
        "geo": {
            "countries": [
                "CN",
                "US"
            ]
        },
        "mode": "allow",
        "os": [
            "string"
        ],
        "require_ad_click": true,
        "temp_jump_enabled": true,
        "temp_jump_url": "string"
    },
    "group_id": 0,
    "limit_action": 0,
    "scene": "string",
    "target_url": "string",
    "valid_time": 0,
    "visit_limit": 0,
    "visit_pwd": "string",
    "visit_type": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.mxsd.com/openapi/v1/short/common' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "chain_title": "string",
    "channels": [
        {
            "cap": 0,
            "ext": {
                "attribution": true,
                "device": "不限",
                "env": "不限",
                "os": "不限",
                "priority": 0,
                "region_name": "string",
                "regions": [
                    "string"
                ],
                "stat_only": true
            },
            "name": "string",
            "sort": 0,
            "status": 0,
            "target_url": "string",
            "valid_time": 0,
            "weight": 0
        }
    ],
    "code": "string",
    "daily_limit": 0,
    "domain": "s.example.com",
    "filter_rule": {
        "browser": [
            "string"
        ],
        "device": [
            "string"
        ],
        "geo": {
            "countries": [
                "CN",
                "US"
            ]
        },
        "mode": "allow",
        "os": [
            "string"
        ],
        "require_ad_click": true,
        "temp_jump_enabled": true,
        "temp_jump_url": "string"
    },
    "group_id": 0,
    "limit_action": 0,
    "scene": "string",
    "target_url": "string",
    "valid_time": 0,
    "visit_limit": 0,
    "visit_pwd": "string",
    "visit_type": 0
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "result": {
        "admin_blocked": 0,
        "admin_blocked_reason": "string",
        "chain_title": "string",
        "code": "string",
        "code_custom": 0,
        "created_at": "string",
        "domain": "string",
        "domain_id": 0,
        "group_id": 0,
        "id": 0,
        "inactive_at": "string",
        "inactive_reason": "string",
        "rule_version": 0,
        "scheme": "string",
        "status": 0,
        "sub_type": 0,
        "target_url": "string",
        "type": 0,
        "user_id": 0,
        "valid_time": 0,
        "visit_type": 0
    },
    "status": 1
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠429

🔴500服务器错误

修改于 2026-10-11 09:23:23

小红书聚光 · 设置临时跳转

批量创建通用短链