conversation

未特别说明情况下请求域名均为 https://chat-go.jwzhd.com
没写请求/响应项目表示不需要相关参数.

将对话设为已读

POST /v1/conversation/dismiss-notification

请求头:

名称	必须	备注
token	是	无

请求体:

{
 "chatId": "123" // 用户/机器人/群组 ID
}

响应体:

{
 "code": 1,
 "msg": "success"
}

获取对话列表

POST /v1/conversation/list

请求头:

名称	必须	备注
token	是	无

请求体:

message ConversationListRequest {
  string md5 = 2; // 上次获取对话的 MD5, 如果与服务端一致则返回空列表
}

响应体:

message ConversationListResponse {
  Status status = 1;
  repeated Data data = 2;
  uint64 total = 3; // 列表中对话的数量
  string md5 = 4; // 对话列表的 md5

  message Data {
    string chat_id = 1; // 对象 ID
    ChatType chat_type = 2; // 对象类型
    string remark = 3; // 备注名称
    string chat_content = 4; // 消息内容
    uint64 timestamp_ms = 5; // 加入对话列表时间戳(毫秒)
    int32 unread_msg = 6; // 未读消息数
    bool at = 7; // 是否被@
    uint64 avatar_id = 8; // 头像 ID
    string avatar_url = 9; // 头像 URL
    bool do_not_disturb = 11; // 免打扰
    uint64 send_timestamp = 12; // 消息发送时间戳(秒)
    AtData at_data = 14; // @数据
    string name = 15; // 用户真实名称
    int32 certification_level = 16; // 认证,1 是官方 2 是地区

    message AtData {
      uint64 unknown = 1; // 似乎是名称 ID
      string mentioned_id = 2; // 被@的 ID,感觉没啥用
      string mentioned_name = 3; // 被@的名称,感觉也没啥用
      string mentioned_in = 4; // @消息所属的对话 ID(例如群 ID),感觉还没啥用
      string mentioner_id = 6; // 发起@的对象 ID
      string mentioner_name = 7; // 发起@对象的名称
      uint64 msg_seq = 8; // 发起@的消息序列
    }
  }
}

更改对话排序

POST /v1/conversation/sort-change

请求头:

名称	必须	备注
token	是	无

请求体:

{
  "userId": "123" // 对象 ID
}

响应体:

{
 "code": 1,
 "msg": "success"
}

删除对话

POST /v1/conversation/remove

请求头:

名称	必须	备注
token	是	无

请求体:

{
  "chatId": "123" // 对象 ID
}

响应体:

{
 "code": 1,
 "msg": "success"
}