API 文档 v1

支持单个链接生成、批量生成、小程序短链、二维码生成。

接口说明
  • 接口地址：https://suo.run/api/v1
  • 请求方式：POST
  • 内容类型：application/json
  • 响应结构：code / msg / data
  • 认证方式：API Key （ 创建API Key ）
示例请求头
Content-Type: application/json
X-API-Key: 你的APIKey
POST /api/v1/generate 生成短链接
参数说明
参数 说明
url 原始链接
expire 有效期天数
custom_code 自定义短码
password 访问密码
ua_stay 访问平台策略
ua_plan 访问平台白名单
site_id 短域名配置 ID
示例请求
{
  "url": "https://example.com",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
示例响应
{
  "code": 1,
  "msg": "success",
  "data": {
    "original_url": "https://example.com",
    "short_url": "http://j58s.c1n.me",
    "short_code": "j58s",
    "expire_time": "2026-02-13 00:15:25",
    "site_url": "j58s.c1n.me"
  }
}
POST /api/v1/batchGenerate 批量生成短链接
参数说明
参数 说明
urls URL 列表（最多 100 条）
expire 有效期天数
password 访问密码
ua_stay 访问平台策略
ua_plan 访问平台白名单
site_id 短域名配置 ID
示例请求
{
  "urls": [
    "https://example.com/a",
    "https://example.com/b"
  ],
  "expire": 7,
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
示例响应
{
  "code": 1,
  "msg": "success",
  "data": {
    "results": [
      {
        "original_url": "https://example.com/a",
        "short_url": "http://bf63sr.c1n.me",
        "site_url": "bf63sr.c1n.me"
      },
      {
        "original_url": "https://example.com/b",
        "short_url": "http://3yj2oy.c1n.me",
        "site_url": "3yj2oy.c1n.me"
      }
    ],
    "expire_time": "2026-02-13 00:05:11",
    "errors": [],
    "total": 2,
    "success_count": 2,
    "error_count": 0
  }
}
POST /api/v1/miniApp 生成小程序短链
参数说明
参数 说明
appid 小程序 AppID
appsecret 小程序 AppSecret
page 小程序页面路径（支持 ?query）
expire 有效期天数
custom_code 自定义短码
password 访问密码
ua_stay 访问平台策略
ua_plan 访问平台白名单
site_id 短域名配置 ID
示例请求
{
  "appid": "小程序 AppID",
  "appsecret": "小程序 AppSecret",
  "page": "pages/index",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
示例响应
{
  "code": 1,
  "msg": "success",
  "data": {
    "original_url": "weixin://dl/business/?t=Sctv5oaz0Id",
    "short_url": "http://vmei.c1n.me",
    "short_code": "vmei",
    "expire_time": "2026-02-13 00:15:31",
    "site_url": "vmei.c1n.me"
  }
}
POST /api/v1/qcodeGenerate 二维码生成
参数说明
参数 说明
url 原始链接
expire 有效期天数
custom_code 自定义短码
password 访问密码
ua_stay 访问平台策略
ua_plan 访问平台白名单
site_id 短域名配置 ID
示例请求
{
  "url": "https://example.com",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
示例响应
{
  "code": 1,
  "msg": "success",
  "data": {
    "original_url": "https://example.com",
    "short_url": "http://8fw6.c1n.me",
    "short_code": "8fw6",
    "expire_time": "2026-02-13 00:15:32",
    "site_url": "8fw6.c1n.me",
    "qr_url": "https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=http%3A%2F%2F8fw6.c1n.me"
  }
}