获取 app 中的子区

功能说明

• 分页获取应用下的子区列表。
• 单个 app 下的子区总数默认为 10 万，如需调整请联系商务。
• 使用该接口前，你需要在环信控制台开通子区功能。

调用频率上限

100 次/秒/App Key

请求 URL

GET https://{host}/{org_name}/{app_name}/thread?limit={limit}&cursor={cursor}&sort={sort}

关于请求 URL 中的参数说明，详见 请求 URL 参数介绍。

查询参数的说明如下表所示：

参数	类型	是否必需	描述
limit	Int	否	每次期望返回的子区数量，取值范围为 [1,50]，默认值为 50。
cursor	String	否	数据查询的起始位置。
sort	String	否	获取的子区的排序顺序： - asc：按子区创建时间的正序； - （默认）desc：按子区创建时间的倒序。

请求示例

# 将 <YourAppToken> 替换为你在服务端生成的 App Token

curl -X GET https://XXXX/XXXX/XXXX/thread   \
-H 'Authorization: Bearer <YourAppToken>'

请求 header 参数

关于 Authorization 字段的说明，详见 请求 header 参数说明。

响应示例

{
  "action": "get",
  "applicationName": "testapp",
  "duration": 7,
  "entities": [
    {
      "id": "1XXXX8"
    }
  ],
  "organization": "XXXX",
  "properties": {
    "cursor": "ZGXXXXTE"
  },
  "timestamp": 1650869750247,
  "uri": "https://XXXX/XXXX/XXXX/thread"
}

响应 body 字段

如果返回的 HTTP 状态码为 200，表示请求成功，响应包体中 entities 包含以下字段：

字段	类型	描述
entities	JSON Array	响应数据。
- id	String	子区 ID。

其他字段的说明如下：

字段	类型	描述
action	String	请求方法。
applicationName	String	你在环信控制台创建应用时填入的应用名称，与请求参数 app_name 相同。
duration	Int	从发送请求到响应的时长，单位为毫秒。
organization	String	环信即时通讯 IM 为每个公司（组织）分配的唯一标识，与请求参数 org_name 相同。
properties.cursor	String	查询游标，指定下次查询的起始位置。
timestamp	Long	Unix 时间戳，单位为毫秒。
uri	String	请求 URL。

错误码

如果返回的 HTTP 状态码非 200，表示请求失败，可能提示以下错误码：

HTTP 状态码	错误类型	错误提示	可能原因	处理建议
400	group_error	query param reaches limit.	分页参数 limit 的值过大。	检查查询参数 limit 是否在取值范围（[1,50]）内。
401	unauthorized	Unable to authenticate (OAuth)	token 不合法，可能过期或 token 错误。	使用新的 token 访问。
403	group_error	thread not open.	子区功能未开通。	请在环信控制台开通子区服务。

关于其他错误，你可以参考 响应状态码 了解可能的原因。