查询短链列表

分页查询短链列表，支持按域名、类型、访问码、状态、创建时间、点击次数等条件过滤。

POST/api/link/list查询短链列表

请求参数 (application/json)

字段	类型	必填	说明
`pageSize`	integer (int32)	可选	每页数量
`pageNum`	integer (int32)	可选	页码
`domain`	string	可选	当前选中的域名，为 null 则查全部
`linkType`	string	可选	短链类型：OY 普通短链、WL 微信外链、WMP 小程序链接
`visitCode`	string	可选	短链访问码
`status`	integer (int32)	可选	状态：0 正常、1 停止访问、2 被封禁
`createdTimeStart`	string (date-time)	可选	创建时间-开始
`createdTimeEnd`	string (date-time)	可选	创建时间-结束
`totalClickCntMin`	integer (int64)	可选	最小访问次数
`totalClickCntMax`	integer (int64)	可选	最大访问次数

响应字段

字段	类型	必填	说明
`code`	string	可选	状态码
`message`	string	可选	提示信息
`data`	object	可选	分页数据
`pageNum`	integer (int64)	可选	当前页码
`pageSize`	integer (int64)	可选	页容
`total`	integer (int64)	可选	数据总数
`list`	array	可选	结果集
`id`	integer (int64)	可选	短链 ID
`linkType`	string	可选	短链类型：OY 普通短链、WL 微信外链、WMP 小程序链接
`sourceLink`	string	可选	原始链接
`visitPrefix`	string	可选	访问前缀（域名部分）
`visitCode`	string	可选	短链访问码
`ownDomain`	integer (int32)	可选	是否自有域名 0-否 1-是
`sslFlag`	integer (int32)	可选	是否开启 SSL 0-否 1-是
`status`	integer (int32)	可选	状态 0-正常 1-停止访问 2-被封禁
`totalClickCnt`	integer (int64)	可选	累计点击次数
`todayClickCnt`	integer (int64)	可选	今日点击次数
`expireDate`	string (date-time)	可选	过期时间
`createdTime`	string (date-time)	可选	创建时间
`success`	boolean	可选	请求是否成功

cURL

curl -X POST 'https://open.xnanlink.com/api/link/list' \
  -H 'Content-Type: application/json' \
  -H 'Token: YOUR_TOKEN' \
  -d '{
    "pageNum": 1,
    "pageSize": 20,
    "domain": "lxs.la",
    "status": 0
  }'

JSON

{
  "code": "OK",
  "message": "成功",
  "data": {
    "pageNum": 1,
    "pageSize": 20,
    "total": 158,
    "list": [{
      "id": 100001,
      "linkType": "OY",
      "sourceLink": "https://www.example.com/page?id=123",
      "visitPrefix": "lxs.la",
      "visitCode": "abc123",
      "ownDomain": 0,
      "sslFlag": 1,
      "status": 0,
      "totalClickCnt": 3580,
      "todayClickCnt": 42,
      "createdTime": "2026-01-15T10:30:00"
    }]
  },
  "success": true
}