API 参考
圈组

查询服务器的申请和邀请记录

更新时间: 2024/07/17 17:57:35

云信服务端支持查询指定时间段内,圈组的服务器维度下的申请和邀请记录。查询需要拥有“申请邀请历史查看权限”。

URL

httpPOST https://api.netease.im/nimserver/qchat/queryInviteApplyHistoryByServer.action  HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8

请求参数

  • POST 请求中 Headers 的设置请参考API调用方式

  • POST 请求中 Body 的设置如下:

参数类型必须说明
accidString查询者的 IM 账号查询者需要拥有“申请邀请历史查看权限”,否则将返回 403 错误码。
serverIdLong服务器 ID
fromTimeLong开始时间戳,单位:毫秒,默认 0
toTimeLong结束时间戳,单位:毫秒,默认当前时间
excludeRecordIdLong排除的记录 ID
limitint本次查询的数量上限,最大数量 100
reverseint是否逆序,0 或 1,默认 0,表示从现在往过去查询

返回参数

参数 状态码
code 状态码
data 查询到的信息,具体包含的字段见下表
data 的字段
类型
说明
serverId Long 服务器 ID
accid Long 用户的 IM 账号
type int 申请邀请记录的类型:
  • 1:APPLY,表示申请记录
  • 2:INVITE,表示邀请记录
  • 3:INVITE_ACK,表示邀请 ACK 记录,可能同意,也可能拒绝
  • 4:INVITE_CODE,表示申请邀请码记录
  • 5:INVITE_CODE_JOIN,表示通过邀请码加入服务器的记录
status int 申请或邀请的状态:
  • 0:初始状态
  • 1:已同意
  • 2:已拒绝
  • 3:通过其他“申请/邀请”同意
  • 4:通过其他“申请/邀请"拒绝
  • 5:邀请或申请时自动加入
  • 6:申请或邀请已过期
  • 用户收到重复邀请时,如果用户已同意了其中一个邀请,那么其他重复的邀请的状态将被云信服务端自动标记为“已通过其他邀请同意”
  • 用户重复申请加入,如果其中一个申请被同意了,那么其他重复的申请的状态被云信服务端自动标记为“已通过其他申请同意”
  • 拒绝的情况同理,会被云信服务端自动标记为“已通过其他邀请/申请拒绝”
requestId Long 申请或邀请的唯一标识
createTime Long 申请或邀请的创建时间
updateTime Long 申请或邀请的更新时间
expireTime Long 申请或邀请的过期时间
data Long 可转成 JSON 格式,根据申请邀请记录类型(type)的不同,返回不同的 data 信息,具体请参考下文的data 详细信息
recordId Long 记录的唯一标识

data 详细信息

  • type=1,表示申请记录,data 中包含如下内容:
{"applyMsg": "xxx",  //申请附言
 "updateAccid": "acc01",   //执行同意或拒绝操作的用户账号
 "updateMsg": "yyy"  //同意或拒绝操作的附言
 }
  • type=2,表示邀请记录,data 中包含如下内容:
{"inviteMsg": "xxx",  //邀请附言
 "inviteUsers": [{      //被邀请人的信息
     "accid": "acc01",   //用户账号
      "status": 1,    //邀请的状态
      "updateMsg": "xxx", //同意或拒绝操作的附言
      "updateTime": 11111  //执行同意或拒绝操作的更新时间
      },
      {"accid": "acc01", "status": 0}
    ]
}
  • type=3,表示邀请 ACK 记录,可能同意,也可能拒绝,data 中包含如下内容:
{"inviteMsg": "xxx",  //邀请附言
 "updateMsg": "yyy"  //同意或拒绝操作的附言
 }
  • type=4,表示申请邀请码的记录,data 中包含如下内容:
{"inviteMsg": "xxx",  //邀请附言
 "inviteCode": "AS102SA12",  //邀请码
 "inviteUserCount": 10 //已经邀请的用户数量
 }
  • type=5,表示通过邀请码加入服务器的记录,data 中包含如下内容:
{"updateMsg": "xxx",  //加入服务器的附言
 "inviteCode": "AS102SA12"  //邀请码
 }

示例

curl请求示例

curlcurl -X POST -H "AppKey: go9dnk49bkd9jd**803mgq3" -H "Nonce: 4tggge**t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'serverId=123&accid=zhasa' 'https://api.netease.im/nimserver/qchat/queryInviteApplyHistoryByServer.action'

返回示例

HTTP 响应:JSON

json"Content-Type": "application/json; charset=utf-8"
{
    "code": 200,
    "data":
    [
        {
            "serverId": 123,
            "accid": "sasa",
            "type": 1,
            "status": 0,
            "requestId": 122,
            "recordId": 123,
            "createTime": 2121,
            "updateTime": 1212,
            "expireTime": 2121,//申请/邀请到期时间
            "data": {"applyMsg": "xxx", "updateAccid": "acc01", "updateMsg": "yyy"}
        }
    ]
}

状态码

该接口在 HTTPS Body 中返回请求的状态码,以下仅列出与接口业务强相关的状态码。完整状态码请参见状态码

状态码 说明 处理建议
200 请求成功 -
403 非法操作或没有权限
  • 检查是否已开通圈组功能
  • 检查查询者是否拥有“申请邀请历史查看权限”
404 对象不存在
  • 检查是否存在必传参数为空的问题
  • 检查传入的 IM 账号、服务器 ID 或记录 ID 是否存在
414 参数错误 根据提示信息,检查传入参数的格式和限制条件
416 调用频率超限 降低调用频率
431 HTTP 重复请求 -
此文档是否对你有帮助?
有帮助
去反馈
  • URL
  • 请求参数
  • 返回参数
  • 示例
  • curl请求示例
  • 返回示例
  • 状态码