咔链使用指南

了解常用功能，按步骤创建、管理和分享你的短链接。

1. 咔链短链接简介

1.1 咔链能做什么

咔链把冗长的网址变成简洁、易分享的短链接。你可以用它推广活动、分发内容、连接小程序，并通过访问数据了解每条链接的传播效果。

原始链接https://shop.example.com/campaign/summer?channel=wechat

短链接 · 示例地址go.example.com/Summer

分享更轻松

适用于社群、短信、海报，让长网址更简洁。

跳转更灵活

按设备或软件匹配目标，让访客到达合适的页面。

效果看得见

查看访问量与访客分布，比较渠道传播效果。

1.2 短链类型

普通短链

连接网站、商品或活动页，适合日常分享与营销推广。

小程序短链

连接微信小程序页面，支持微信复制的小程序链接和 AppID 两种创建方式。

2. API 接口管理

将短链创建、管理与智能跳转接入自己的业务系统。业务接口统一使用 /api/open 前缀。

2.1 接入前置

获取 API Token，并通过 Authorization 请求头完成鉴权。

API 服务地址

https://api.cutlink.cn，接口统一前缀为 /api/open。例如创建短链的完整请求地址为 https://api.cutlink.cn/api/open/links。此地址用于调用 API，与创建短链时选择的域名无关。

获取 API Token
登录控制台 → 我的账户 → API Token → 创建 Token。完整凭证仅在创建或刷新时显示一次，请及时保存到服务端配置。
设置请求头
```
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
```
每次请求携带 API Token，即可操作本人短链。Token 代表账户执行操作，不得写入网页或公开仓库。
验证接入
选择需要接入的能力，按对应章节的请求示例调用；凭证无效或权限不足时读取 error.message。

请求规范与使用限制

项目	规范
鉴权与权限	使用 Bearer API Token，仅可操作所属账户的资源；有效 Token 可调用全部已开放的短链与分组接口。访问统计仅在控制台提供，不对 API 开放。
数据格式	请求体采用 JSON；成功结果读取 data，分页信息读取 meta。用完整短链接定位资源，响应不包含内部 ID。
时间格式	请求日期时间使用 ISO 8601；例如 `2026-10-02T09:30:00`；示例时间按服务所在时区解释，请勿自行附加时区偏移。短链响应的 createdAt、startAt、endAt 当前为毫秒时间戳，startAt / endAt 可为空。
创建额度	API 与控制台共用账户的每日及累计创建额度。同一账户请串行提交创建请求。
调用频率	所有查询共用 30 次/分钟额度；创建、修改、删除共用 20 次/分钟额度，Token 与账户均受限制，多 Token 不能增加账户额度。批量创建还与控制台共用账户 20 次/分钟限制，每次最多 100 条。超限返回 HTTP 200，响应中的 error.code 为 1005，请按 Retry-After 响应头指定秒数等待后重试。
异常与重试	同时检查 HTTP 状态和 error。频率超限按 Retry-After 响应头指定秒数等待。参数或凭证错误应修正后重试；写入超时应先确认结果，避免重复提交。

常见错误码与处理方式

HTTP 200 不一定表示业务成功。响应包含 error 时，请读取数字 error.code 和 error.message；error.details 可能提供字段提示。未列出的错误以实际提示为准。

错误码	含义	处理方式
`1001`	请求内容不合法	检查必填字段、字段类型、地址及时间格式，修正后提交
`1002 / 1004`	未携带有效凭证或凭证无效	检查 Authorization 请求头；在我的账户检查或刷新 Token
`1005`	请求频率超限	按 Retry-After 响应头指定秒数等待后重试
`1006 / 1034`	短链不存在或不属于当前账户	检查完整短链接及所属账户，不能操作其他账户的短链
`1009 / 1012`	域名不可用或未设置默认域名	在控制台选择可用域名或设置默认域名
`1010`	创建额度不足	在我的账户检查剩余每日及累计创建额度
`1011`	短链后缀已占用	更换后缀，或省略 slug 由系统生成
`1018`	同一账户正在创建短链	等待当前创建完成，再串行提交
`1028`	账户已被禁用	停止调用，并通过平台提供的渠道处理账户问题
`1000 / 1031`	服务暂时不可用	写入请求先查询结果，再决定是否重试；不要直接重复创建

2.2 分组管理

查询、创建和改名分组，也可设置默认分组。每账户最多 50 个分组，包含默认分组，API 与控制台共用名额。创建、筛选和移动短链时使用分组名称；删除分组在控制台操作。

GET/api/open/groups

Path：替换路径中的占位符；Query：放在 URL 的 ? 后；Body：放在 JSON 请求体；Header：放在请求头。

参数	类型	位置	要求	说明
`Authorization`	string	Header	必填	Bearer <API Token>
`page`	integer	Query	可选	从 1 开始，默认 1；小于 1 时使用 1
`page_size`	integer	Query	可选	默认 20，最多 50；超过 50 按 50 返回，小于 1 时使用 20

默认分组优先，其余按更新时间从新到旧返回；同一更新时间的顺序固定。查询不返回短链数量。

请求示例

仅展示代码，不发送请求

请配置自己的 CUTLINK_API_TOKEN，并按业务需要替换示例中的短链接、域名和跳转地址。

curl --silent --show-error --fail-with-body \
  --request GET \
  "https://cutlink.cn/api/open/groups?page=1&page_size=20" \
  --header "Authorization: Bearer $CUTLINK_API_TOKEN" \
  --write-out '\nHTTP %{http_code}\n'

# 同时检查响应中的 error；HTTP 200 不一定表示业务成功

cURL 7.76+；终端运行；设置 CUTLINK_API_TOKEN 环境变量。响应正文与 HTTP 状态一并输出。

返回字段说明

字段	类型	出现条件	说明
data	object[]	成功时返回	当前页分组列表；没有结果时返回空数组
data[].name	string	每个分组	分组名称，创建与修改短链使用 groupName，筛选短链使用 group_name
data[].isDefault	boolean	每个分组	true 表示账户默认分组；创建短链时不传 groupName 即使用此分组
meta.page	integer	成功时返回	当前页码
meta.page_size	integer	成功时返回	实际每页条数，最多 50
meta.total	integer	成功时返回	所属账户的分组总数

返回示例

示例数据；按实际响应读取

{
  "data": [
    {
      "name": "默认分组",
      "isDefault": true
    },
    {
      "name": "活动推广",
      "isDefault": false
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 20,
    "total": 2
  }
}

data 为业务结果；列表接口的 meta 为分页信息。字段类型及出现条件见上表，示例用于说明数据形态。

2.3 创建短链

将网页长链接转换为短链接，支持单条和批量创建。

POST/api/open/links

Path：替换路径中的占位符；Query：放在 URL 的 ? 后；Body：放在 JSON 请求体；Header：放在请求头。

参数	类型	位置	要求	说明
`Authorization`	string	Header	必填	Bearer <API Token>
`Content-Type`	string	Header	必填	application/json
`target`	string	Body · JSON	必填	完整的 HTTP / HTTPS 目标地址
`domain`	string	Body · JSON	可选	可用域名，例如 cutlink.cn（不带 https:// 或路径）；不传使用账户默认域名。自有域名需先在控制台添加并验证。
`groupName`	string	Body · JSON	可选	已有分组名称；省略使用默认分组
`title`	string	Body · JSON	可选	用于识别短链的名称
`slug`	string	Body · JSON	可选	1～10 位英文字母或数字；省略时自动生成
`startAt`	string	Body · JSON	可选	生效时间，例如 2026-10-09T09:30:00；不传不设置此时间限制，生效时间不得晚于失效时间
`endAt`	string	Body · JSON	可选	失效时间，例如 2026-10-09T09:30:00；不传不设置此时间限制，生效时间不得晚于失效时间

请求示例

仅展示代码，不发送请求

请配置自己的 CUTLINK_API_TOKEN，并按业务需要替换示例中的短链接、域名和跳转地址。

curl --silent --show-error --fail-with-body \
  --request POST \
  "https://cutlink.cn/api/open/links" \
  --header "Authorization: Bearer $CUTLINK_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "target": "https://shop.example.com/summer",
  "title": "夏日活动",
  "slug": "Summer"
}' \
  --write-out '\nHTTP %{http_code}\n'

# 同时检查响应中的 error；HTTP 200 不一定表示业务成功

cURL 7.76+；终端运行；设置 CUTLINK_API_TOKEN 环境变量。响应正文与 HTTP 状态一并输出。

返回字段说明

字段	类型	出现条件	说明
data	object	成功时返回	短链详情
data.shortUrl	string	每条短链	完整短链接；后续查询、修改或删除使用此地址
data.target	string	每条短链	当前默认跳转地址；小程序可能是 #小程序:// 地址或微信生成的链接
data.title	string / null	每条短链	短链名称；没有名称时可能为空
data.linkType	string	每条短链	normal：网页短链；miniapp：小程序短链
data.status	string	每条短链	active：正常状态；disabled：已禁用。正常状态仍受有效期、额度及访问限制约束
data.createdAt	integer	每条短链	创建时间，毫秒时间戳，例如 1790899200000
data.startAt	integer / null	每条短链	生效时间，毫秒时间戳；为空表示没有起始时间限制
data.endAt	integer / null	每条短链	失效时间，毫秒时间戳；为空表示没有结束时间限制
data.domainBlocked	boolean	每条短链	域名拦截提示；不能单独据此判断短链是否可访问
data.platformBlocked	boolean	每条短链	平台拦截提示；可访问性还需结合状态、有效期和实际访问结果
data.miniapp	object	有小程序资料时	小程序信息；网页短链不返回该对象
data.miniapp.generationType	string	有小程序资料时	url：已有小程序链接；appid：AppID 生成
data.miniapp.appId	string / null	有小程序资料时	小程序 AppID；已有链接方式可能为空
data.miniapp.pagePath	string / null	有小程序资料时	小程序页面路径；已有链接方式可能为空
data.miniapp.wxaUrl	string	有小程序资料时	已保存的小程序链接
data.miniapp.hasAppSecret	boolean	有小程序资料时	是否已保存应用密钥；不会返回密钥或密文

返回示例

示例数据；按实际响应读取

{
  "data": {
    "title": "夏日活动",
    "shortUrl": "https://go.example.com/Summer",
    "target": "https://shop.example.com/summer",
    "linkType": "normal",
    "status": "active",
    "createdAt": 1790899200000,
    "endAt": null,
    "startAt": null
  }
}

data 为业务结果；列表接口的 meta 为分页信息。字段类型及出现条件见上表，示例用于说明数据形态。

2.4 创建小程序短链

通过已有小程序链接或 AppID 生成小程序短链。

POST/api/open/links/miniapp

Path：替换路径中的占位符；Query：放在 URL 的 ? 后；Body：放在 JSON 请求体；Header：放在请求头。

参数	类型	位置	要求	说明
`Authorization`	string	Header	必填	Bearer <API Token>
`Content-Type`	string	Header	必填	application/json
`title`	string	Body · JSON	可选	用于识别短链的名称
`domain`	string	Body · JSON	可选	可用域名，例如 cutlink.cn（不带 https:// 或路径）；不传使用账户默认域名。自有域名需先在控制台添加并验证。
`groupName`	string	Body · JSON	可选	已有分组名称；省略使用默认分组
`slug`	string	Body · JSON	可选	1～10 位英文字母或数字；省略时自动生成
`startAt`	string	Body · JSON	可选	生效时间，例如 2026-10-09T09:30:00；不传不设置此时间限制，生效时间不得晚于失效时间
`endAt`	string	Body · JSON	可选	失效时间，例如 2026-10-09T09:30:00；不传不设置此时间限制，生效时间不得晚于失效时间
`generationType`	string	Body · JSON	必填	url：微信复制的小程序链接；appid：通过应用信息生成
`wxaUrl`	string	Body · JSON	条件必填	url 模式必填，须以 #小程序:// 开头

提交微信中复制的 #小程序:// 链接，不需要 AppID 或 AppSecret。

请求示例

仅展示代码，不发送请求

请配置自己的 CUTLINK_API_TOKEN，并按业务需要替换示例中的短链接、域名和跳转地址。

curl --silent --show-error --fail-with-body \
  --request POST \
  "https://cutlink.cn/api/open/links/miniapp" \
  --header "Authorization: Bearer $CUTLINK_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "title": "小程序活动",
  "generationType": "url",
  "wxaUrl": "#小程序://示例小程序/实际分享路径"
}' \
  --write-out '\nHTTP %{http_code}\n'

# 同时检查响应中的 error；HTTP 200 不一定表示业务成功

cURL 7.76+；终端运行；设置 CUTLINK_API_TOKEN 环境变量。响应正文与 HTTP 状态一并输出。

返回字段说明

字段	类型	出现条件	说明
data	object	成功时返回	短链详情
data.shortUrl	string	每条短链	完整短链接；后续查询、修改或删除使用此地址
data.target	string	每条短链	当前默认跳转地址；小程序可能是 #小程序:// 地址或微信生成的链接
data.title	string / null	每条短链	短链名称；没有名称时可能为空
data.linkType	string	每条短链	normal：网页短链；miniapp：小程序短链
data.status	string	每条短链	active：正常状态；disabled：已禁用。正常状态仍受有效期、额度及访问限制约束
data.createdAt	integer	每条短链	创建时间，毫秒时间戳，例如 1790899200000
data.startAt	integer / null	每条短链	生效时间，毫秒时间戳；为空表示没有起始时间限制
data.endAt	integer / null	每条短链	失效时间，毫秒时间戳；为空表示没有结束时间限制
data.domainBlocked	boolean	每条短链	域名拦截提示；不能单独据此判断短链是否可访问
data.platformBlocked	boolean	每条短链	平台拦截提示；可访问性还需结合状态、有效期和实际访问结果
data.miniapp	object	有小程序资料时	小程序信息；网页短链不返回该对象
data.miniapp.generationType	string	有小程序资料时	url：已有小程序链接；appid：AppID 生成
data.miniapp.appId	string / null	有小程序资料时	小程序 AppID；已有链接方式可能为空
data.miniapp.pagePath	string / null	有小程序资料时	小程序页面路径；已有链接方式可能为空
data.miniapp.wxaUrl	string	有小程序资料时	已保存的小程序链接
data.miniapp.hasAppSecret	boolean	有小程序资料时	是否已保存应用密钥；不会返回密钥或密文

返回示例

示例数据；按实际响应读取

{
  "data": {
    "title": "小程序活动",
    "shortUrl": "https://go.example.com/Summer",
    "target": "#小程序://示例小程序/实际分享路径",
    "linkType": "miniapp",
    "status": "active",
    "createdAt": 1790899200000,
    "endAt": null,
    "startAt": null
  }
}

data 为业务结果；列表接口的 meta 为分页信息。字段类型及出现条件见上表，示例用于说明数据形态。

2.5 修改短链

修改跳转地址、名称、分组和有效期，原短链接不变。只提交需要修改的内容；未提交的内容保持原样。

PATCH/api/open/links/by-url

Path：替换路径中的占位符；Query：放在 URL 的 ? 后；Body：放在 JSON 请求体；Header：放在请求头。

参数	类型	位置	要求	说明
`Authorization`	string	Header	必填	Bearer <API Token>
`Content-Type`	string	Header	必填	application/json
`shortUrl`	string	Body · JSON	必填	要操作的完整短链接，例如 https://go.example.com/Summer，填写在 JSON 请求体中
`target`	string	Body · JSON	可选 · 普通短链	新的完整网页地址，以 http:// 或 https:// 开头；不传则保留原跳转地址
`title`	string / null	Body · JSON	可选	短链名称；不传则保留原名称，传空字符串可清空名称
`groupName`	string	Body · JSON	可选	本人已有的分组名称；不传则保留当前分组
`startAt`	string / null	Body · JSON	可选	生效时间，例如 2026-10-09T09:30:00；不传保留原值，生效时间不得晚于失效时间
`endAt`	string / null	Body · JSON	可选	失效时间，例如 2026-10-09T09:30:00；不传保留原值，生效时间不得晚于失效时间

至少提交一项修改内容。不需要修改的字段请省略。若需取消生效或失效时间，显式提交对应字段为 JSON null；这与省略字段不同。

请求示例

仅展示代码，不发送请求

请配置自己的 CUTLINK_API_TOKEN，并按业务需要替换示例中的短链接、域名和跳转地址。

curl --silent --show-error --fail-with-body \
  --request PATCH \
  "https://cutlink.cn/api/open/links/by-url" \
  --header "Authorization: Bearer $CUTLINK_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "shortUrl": "https://go.example.com/Summer",
  "target": "https://shop.example.com/new-campaign",
  "title": "新活动"
}' \
  --write-out '\nHTTP %{http_code}\n'

# 同时检查响应中的 error；HTTP 200 不一定表示业务成功

cURL 7.76+；终端运行；设置 CUTLINK_API_TOKEN 环境变量。响应正文与 HTTP 状态一并输出。

返回字段说明

字段	类型	出现条件	说明
data	boolean	成功时返回	true 表示操作已完成；出现 error 时按失败处理

返回示例

示例数据；按实际响应读取

{
  "data": true
}

data 为业务结果；列表接口的 meta 为分页信息。字段类型及出现条件见上表，示例用于说明数据形态。

2.7 查询短链

查询短链详情或分页查询列表。列表按创建时间从新到旧返回；创建时间相同的记录不保证先后顺序，暂不支持自定义排序。时间范围按创建时间筛选，与短链有效期无关。

GET/api/open/links

Path：替换路径中的占位符；Query：放在 URL 的 ? 后；Body：放在 JSON 请求体；Header：放在请求头。

参数	类型	位置	要求	说明
`Authorization`	string	Header	必填	Bearer <API Token>
`page`	integer	Query	可选	整数页码，从 1 开始，默认 1
`page_size`	integer	Query	可选	整数，每页默认 20 条，最多 50 条；超过 50 按 50 返回
`q`	string	Query	可选	搜索短链名称、完整短链或目标地址；作为网址中的 q 值传入
`group_name`	string	Query	可选	已有分组名称
`link_type`	string	Query	可选	normal 或 miniapp
`start_at`	string	Query	可选	按创建时间筛选的起点（含），例如 2026-10-02T09:30:00；不传不限制起点
`end_at`	string	Query	可选	按创建时间筛选的终点（含），例如 2026-10-09T18:00:00；不传不限制终点，起点不得晚于终点

请求示例

仅展示代码，不发送请求

请配置自己的 CUTLINK_API_TOKEN，并按业务需要替换示例中的短链接、域名和跳转地址。

curl --silent --show-error --fail-with-body \
  --request GET \
  "https://cutlink.cn/api/open/links?page=1&page_size=10&link_type=normal" \
  --header "Authorization: Bearer $CUTLINK_API_TOKEN" \
  --write-out '\nHTTP %{http_code}\n'

# 同时检查响应中的 error；HTTP 200 不一定表示业务成功

cURL 7.76+；终端运行；设置 CUTLINK_API_TOKEN 环境变量。响应正文与 HTTP 状态一并输出。

返回字段说明

字段	类型	出现条件	说明
data	object[]	成功时返回	短链列表；没有结果时返回空数组
data[].shortUrl	string	每条短链	完整短链接；后续查询、修改或删除使用此地址
data[].target	string	每条短链	当前默认跳转地址；小程序可能是 #小程序:// 地址或微信生成的链接
data[].title	string / null	每条短链	短链名称；没有名称时可能为空
data[].linkType	string	每条短链	normal：网页短链；miniapp：小程序短链
data[].status	string	每条短链	active：正常状态；disabled：已禁用。正常状态仍受有效期、额度及访问限制约束
data[].createdAt	integer	每条短链	创建时间，毫秒时间戳，例如 1790899200000
data[].startAt	integer / null	每条短链	生效时间，毫秒时间戳；为空表示没有起始时间限制
data[].endAt	integer / null	每条短链	失效时间，毫秒时间戳；为空表示没有结束时间限制
data[].domainBlocked	boolean	每条短链	域名拦截提示；不能单独据此判断短链是否可访问
data[].platformBlocked	boolean	每条短链	平台拦截提示；可访问性还需结合状态、有效期和实际访问结果
data[].miniapp	object	有小程序资料时	小程序信息；网页短链不返回该对象
data[].miniapp.generationType	string	有小程序资料时	url：已有小程序链接；appid：AppID 生成
data[].miniapp.appId	string / null	有小程序资料时	小程序 AppID；已有链接方式可能为空
data[].miniapp.pagePath	string / null	有小程序资料时	小程序页面路径；已有链接方式可能为空
data[].miniapp.wxaUrl	string	有小程序资料时	已保存的小程序链接
data[].miniapp.hasAppSecret	boolean	有小程序资料时	是否已保存应用密钥；不会返回密钥或密文
meta	object	分页列表成功时	分页信息
meta.page	integer	分页列表成功时	当前页码
meta.page_size	integer	分页列表成功时	本次实际每页条数，最多 50
meta.total	integer	分页列表成功时	符合筛选条件的短链总数

返回示例

示例数据；按实际响应读取

{
  "data": [
    {
      "title": "夏日活动",
      "shortUrl": "https://go.example.com/Summer",
      "target": "https://shop.example.com/summer",
      "linkType": "normal",
      "status": "active",
      "createdAt": 1790899200000,
      "endAt": null,
      "startAt": null
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 10,
    "total": 1
  }
}

data 为业务结果；列表接口的 meta 为分页信息。字段类型及出现条件见上表，示例用于说明数据形态。

2.8 智能跳转

读取、设置按设备跳转或简单随机跳转，也可关闭当前跳转设置。微信卡片、按软件或地区跳转、轮询、访问限制和访客记忆仅在控制台配置。

注意：设置智能跳转会覆盖当前启用的跳转设置

设置设备或随机跳转后，将替换当前跳转方式及该方式的全部规则，并关闭访问限制和随机记忆，包括此前在控制台启用的设置。关闭接口会恢复短链原跳转地址。微信分享卡片及其他已保存规则保留。

GET/api/open/links/routing

Path：替换路径中的占位符；Query：放在 URL 的 ? 后；Body：放在 JSON 请求体；Header：放在请求头。

参数	类型	位置	要求	说明
`Authorization`	string	Header	必填	Bearer <API Token>
`short_url`	string	Query	必填	要查询的完整短链接。作为网址中的 short_url 值传入；示例代码已处理特殊字符，无需手动转换

成功响应读取 data。跳转类型字段为 mode，固定四种取值；请先判断 mode，再读取该类型对应的地址字段。各类型及完整返回示例见下方。

请求示例

仅展示代码，不发送请求

请配置自己的 CUTLINK_API_TOKEN，并按业务需要替换示例中的短链接、域名和跳转地址。

curl --silent --show-error --fail-with-body \
  --request GET \
  "https://cutlink.cn/api/open/links/routing?short_url=https%3A%2F%2Fgo.example.com%2FSummer" \
  --header "Authorization: Bearer $CUTLINK_API_TOKEN" \
  --write-out '\nHTTP %{http_code}\n'

# 同时检查响应中的 error；HTTP 200 不一定表示业务成功

cURL 7.76+；终端运行；设置 CUTLINK_API_TOKEN 环境变量。响应正文与 HTTP 状态一并输出。

跳转类型：data.mode

取值	含义	返回内容	允许的操作
device	按设备跳转	mode + 已设置的设备地址字段	可通过设备接口重新设置，或关闭
random	简单随机跳转	mode + targets 地址数组	可通过随机接口重新设置，或关闭
none	未开启设备或随机跳转	仅 mode	使用短链原跳转地址；可通过 API 设置设备或随机跳转
console	正在使用仅控制台支持的跳转策略	仅 mode	API 不返回该策略详情；可通过设备、随机或关闭接口替换当前设置

返回字段说明

字段	类型	出现条件	说明
data	object	成功时返回	本次查询结果
data.mode	string	始终返回	固定为 device、random、none、console 之一
data.ios	string	mode=device，且该设备已设置地址	苹果手机、iPad的完整跳转地址；字段不出现表示使用短链原地址，不返回空字符串或 null
data.android	string	mode=device，且该设备已设置地址	安卓设备的完整跳转地址；字段不出现表示使用短链原地址，不返回空字符串或 null
data.harmonyos	string	mode=device，且该设备已设置地址	鸿蒙设备的完整跳转地址；字段不出现表示使用短链原地址，不返回空字符串或 null
data.windows	string	mode=device，且该设备已设置地址	Windows 电脑的完整跳转地址；字段不出现表示使用短链原地址，不返回空字符串或 null
data.macos	string	mode=device，且该设备已设置地址	Mac 电脑的完整跳转地址；字段不出现表示使用短链原地址，不返回空字符串或 null
data.other	string	mode=device，且该设备已设置地址	其他设备的完整跳转地址；字段不出现表示使用短链原地址，不返回空字符串或 null
data.targets	string[]	mode=random，已保存随机地址列表	每项是完整跳转地址，每次访问等概率选择一项。若未返回或为空，不应视为已配置可用地址

返回示例

示例数据；按实际响应读取

{
  "data": {
    "mode": "device",
    "ios": "https://example.com/ios",
    "android": "https://example.com/android"
  }
}

以上四种模式覆盖全部成功返回类型；仅返回当前模式的字段。mode=console 表示当前策略的详情仅在控制台提供；仍可通过 API 替换为设备、随机跳转，或关闭。

3. 功能与营销场景

看看这些功能能用在哪些推广场景。

3.1 微信分享卡片

解决什么问题

让分享内容更容易被理解

在社群分享活动、课程或商品时，用标题、摘要和封面说明链接内容，比裸链接更直观。

怎么用

从短链的「分享」菜单打开「微信卡片」，上传封面，填写标题和描述，保存后将短链发送给「咔链公众号」，收到回复的卡片后转发给好友。实际展示以微信为准。

查看分步操作 →

场景示意

12:30

夏日新品 · 限时上新

查看新品款式与活动详情

卡片效果预览

保存后，将短链发送给「咔链公众号」，收到卡片后再分享给好友。

3.2 智能跳转

解决什么问题

一个入口，适配不同访客

海报或社群保留同一条短链，按软件或设备把访客带到适合的页面。例如手机进入移动页，电脑进入桌面页。

怎么用

例如希望手机和电脑打开不同页面：在「智能跳转」中选择「按设备」，填入各自要打开的网址，保存后分别用手机和电脑试一下。

查看分步操作 →

场景示意

同一条短链接

微信 → 微信活动页

浏览器 → 网页活动页

按打开链接的软件选择页面。每次选择一种方式；图中地址仅作示例。

3.3 渠道效果分析

解决什么问题

识别哪些渠道带来访问

为朋友圈、短信、海报分别创建短链，使用相同目标页面和不同标题，便于分别查看访问量。

怎么用

按活动建立分组，再按渠道命名短链。在各条短链的「数据」报表中选择相同时间范围，比较访问次数和访客分布。访问量不等于订单或成交量。

查看分步操作 →

场景示意

微信社群/WeChat

短信推送/Sms

线下海报/Poster

同一活动，不同短链；按渠道分别统计。图形仅作示意。

3.4 品牌专属域名

解决什么问题

让分享地址更有品牌识别度

使用自己的域名生成短链，让活动链接和品牌保持一致。

怎么用

已有自己的域名时，在「独有域名」中添加，按页面提示完成验证。不熟悉域名设置可请域名管理员协助；没有自己的域名也可以创建短链。

查看分步操作 →

场景示意

你的品牌域名go.example.com/Summer

验证归属→配置 HTTPS→创建短链

使用自有域名，保持品牌地址的一致性。

4. 控制台使用指引

按顺序点击下面的步骤，查看在哪里操作、怎么填写，以及完成后应该看到什么。

4.1 账户与安全

操作入口打开控制台 ↗

我的账户

账户信息修改密码

当前套餐

到期时间

今日短链创建 — / —累计短链创建 — / —累计访问次数 — / —

升级 / 续费

API Token

仅系统对接时使用，手动创建短链无需设置。

界面关键区域示意 · 填写内容仅作示例

4.2 分组管理与批量操作

操作入口打开控制台 ↗

分组管理

＋新增分组

新增分组

分组名称

活动推广

取消确定

界面关键区域示意 · 填写内容仅作示例

4.3 创建与管理短链

操作入口打开控制台 ↗

界面关键区域示意 · 填写内容仅作示例

4.4 小程序短链接

操作入口打开控制台 ↗

界面关键区域示意 · 填写内容仅作示例

4.5 智能跳转与访问限制

如何选择跳转方式？

方式	适用情况	需要准备
按软件	微信和浏览器需要打开不同页面	准备各软件对应的网址
按设备	苹果、安卓或电脑需要打开不同页面	准备各设备对应的网址
按地区	不同省份展示不同门店或活动	选择省份并填写对应网址
随机跳转	将访问随机分配到多个页面	填写多个网址；需要访客保持同一分配时开启记忆
轮询跳转	一个页面达到访问次数后切换到下一个	填写网址及每个地址的访问次数上限
访问限制	限制特定软件、设备或地区访问	选择需限制的访客条件；与智能分流不能同时启用

操作入口打开控制台 ↗

短链接管理

夏日活动https://go.example.com/Summer

分享数据编辑智能跳转删除

界面关键区域示意 · 填写内容仅作示例

4.6 微信分享卡片

操作入口打开控制台 ↗

短链接管理

夏日活动https://go.example.com/Summer

分享数据编辑智能跳转

手机端：更多操作 → 分享 → 微信卡片

界面关键区域示意 · 填写内容仅作示例

4.7 查看访问数据

操作入口打开控制台 ↗

控制台概览

访问趋势

今日访问 —昨日 —

24 小时近 7 天

整体访问趋势

访问 TOP 短链近 7 天 · 截至昨日

界面关键区域示意 · 填写内容仅作示例

4.8 独有域名

操作入口打开控制台 ↗

添加域名

1 输入域名2 配置 DNS3 验证域名

你的域名

go.example.com

使用自己的已备案域名。

界面关键区域示意 · 填写内容仅作示例

4.9 套餐、订单与发票

操作入口打开控制台 ↗

我的订单

共 — 笔订单刷新

订单信息金额 / 支付方式 / 状态

套餐订单以账户实际订单为准

界面关键区域示意 · 填写内容仅作示例

5. 常见问题

找到你遇到的问题，按步骤检查；仍未解决时，请保留页面提示或截图，方便反馈。

5.1 为什么无法创建短链？

先看页面提示，通常需要补填网址、换一个短链后缀，或检查剩余额度。

提示信息未填写或不正确：在「跳转链接」粘贴能正常打开的完整网址，并从下拉列表选好域名和分组。
提示后缀（短码）已存在：这是短链接最后一段文字被占用了。换一段文字，或清空后让系统自动生成。
提示额度不足：进入「我的账户」查看剩余可创建数量；提示正在创建：等上一次创建完成后再点击，不要连续提交。

查看创建短链的操作步骤 →

5.2 为什么短链没有跳转到预期页面？

先试着打开原网址，再检查这条短链是否已到期，或者设置了不同的跳转方式。

单独打开创建时填写的原网址或小程序链接。原链接也打不开时，先检查原网站或小程序。
短链打不开：在「短链接管理」确认链接未删除、未到期，并按打开时显示的提示检查。使用自有域名时，可请域名管理员检查。
打开了其他页面：找到这条短链，查看「智能跳转」中的设置。用手机和电脑分别试一下，确认不同设备对应的网址没有填错。

查看智能跳转的操作步骤 →

5.3 为什么微信卡片未按配置显示？

先确认已保存；微信聊天、朋友圈等位置的卡片显示效果可能不同。

找到对应短链，打开「微信卡片」，检查标题、描述、封面是否填写并保存成功。
将短链发送到「咔链公众号」对话框，收到回复的卡片后再分享给好友，检查卡片内容和打开的页面。
仍显示旧标题或封面时，可能是微信保留了之前的内容。稍后再试，并保留分享位置、时间和截图，便于反馈问题。

查看微信卡片的设置步骤 →

5.4 为什么统计数据没有立即变化？

不同数据块的时间范围与更新速度不同，先确认打开的是哪条短链的报表。

从短链列表点击该记录的「数据」，核对报表顶部的标题和短链接；今天的访问先看核心指标的「今天」或访问日志。
每日趋势截至昨日，小时趋势按图表标注的截止时间查看；访客分布也有处理延迟。稍后点击报表右上角「刷新」，不要连续刷新。
PV 是打开链接的次数；UV 根据上网地址（IP）去重。多人使用同一个网络可能只计一次，因此 UV 不等于准确人数。

查看访问统计的使用步骤 →

5.5 API 调用失败如何排查？（开发接入）

本项面向开发接入。只在控制台手动操作的用户无需检查请求代码；遇到问题请保留页面提示。

开发人员同时检查 HTTP 状态和 error.code、error.message。凭证无效时，检查 Authorization: Bearer <Token> 与 Token 状态，默认地址为 https://cutlink.cn。
参数错误时按对应接口的参数表检查 Query 或 JSON Body。用完整短链接定位资源：查询传 short_url，修改或删除传 shortUrl，批量传 shortUrls，不传内部 ID。
频率超限按 Retry-After 等待；额度不足时查看账户额度。写入超时先查询结果，避免重复创建。

查看 API 接入说明 →

1. 咔链短链接简介

1.1 咔链能做什么

分享更轻松

跳转更灵活

效果看得见

1.2 短链类型

普通短链

小程序短链

2. API 接口管理

2.1 接入前置

获取 API Token

设置请求头

验证接入

请求规范与使用限制

2.2 分组管理

请求示例

返回字段说明

返回示例

2.3 创建短链

请求示例

返回字段说明

返回示例

2.4 创建小程序短链

请求示例

返回字段说明

返回示例

2.5 修改短链

请求示例

返回字段说明

返回示例

2.6 删除与移动分组

请求示例

返回字段说明

返回示例

2.7 查询短链

请求示例

返回字段说明

返回示例

2.8 智能跳转

请求示例

跳转类型：data.mode

返回字段说明

返回示例

3. 功能与营销场景

3.1 微信分享卡片

让分享内容更容易被理解

3.2 智能跳转

一个入口，适配不同访客

3.3 渠道效果分析

识别哪些渠道带来访问

3.4 品牌专属域名

让分享地址更有品牌识别度

4. 控制台使用指引

4.1 账户与安全

4.2 分组管理与批量操作

4.3 创建与管理短链

4.4 小程序短链接

4.5 智能跳转与访问限制

4.6 微信分享卡片

4.7 查看访问数据

4.8 独有域名

4.9 套餐、订单与发票

5. 常见问题

5.1 为什么无法创建短链？

5.2 为什么短链没有跳转到预期页面？

5.3 为什么微信卡片未按配置显示？

5.4 为什么统计数据没有立即变化？

5.5 API 调用失败如何排查？（开发接入）