活码列表

分页获取组织下的活码列表，返回每个码的名称与 coding。拿到 coding 后可继续调 活码内容、活码关联操作项列表。

请求示例

Python + requests

import requests

url = "https://open.cli.im/api/v2/rpc/qrcodes/list"
data = {"page_size": 20}
headers = {
    "Authorization": "Bearer <你的API Key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=data, headers=headers)
print(response.text)

curl

curl -X POST 'https://open.cli.im/api/v2/rpc/qrcodes/list' \
  -H 'Authorization: Bearer <你的API Key>' \
  -H 'Content-Type: application/json' \
  -d '{"page_size": 20}'

请求参数

参数	类型	必填	说明
start_time	string	否	起始时间（ISO 8601，如 2026-01-01T00:00:00+08:00），按创建时间过滤
end_time	string	否	结束时间（ISO 8601）
page_token	string	否	上一页返回的 next_page_token；首页不传
page_size	integer	否	每页条数，默认 20，上限 100

完整返回示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "list": [
      { "name": "巡逻点-1", "coding": "qk3mJHJ" },
      { "name": "3号灭火器", "coding": "qm8xKtR" }
    ],
    "next_page_token": "eyJvZmZzZXQiOjIwfQ",
    "total": 3334
  }
}

响应结构

路径	类型	说明
data.list[].name	string	活码名称
data.list[].coding	string	活码 coding，其它活码接口的入参
data.next_page_token	string|null	下一页游标；为 null 表示已到最后一页
data.total	integer	满足条件的总条数

错误响应

错误响应为 {"code": 400, "message": "…", "data": {}} 形态，具体错误码定义见：错误码说明。