最近通讯列表

该功能应用于新设备登录后获取最近一个月的通讯列表，返回结果中包括最近联系的用户和群组信息，按时间降序排列。身份验证方式即客户端使用的token验证。

参数列表

Variable Meanings
$appId 小米开放平台申请的AppId
$appKey 小米开放平台申请的AppKey
$appSecret 小米开放平台申请的AppSecret
$appAccount 查询方在APP帐号系统内唯一ID
$token 查询方的token（使用user.getToken()获取）
$member 与查询方进行会话的用户在APP帐号系统内唯一ID
$topicId 与查询方进行会话的群在APP帐号系统内唯一ID
$sequence sequence主要用来做消息的排序和去重，全局唯一

获取最近通讯列表

  • HTTP 请求

    1. curl "https://mimc.chat.xiaomi.net/api/contact/ -XGET
    2. -H "token:$token"
    3. -H "Content-Type: application/json"

  • JSON结果

    1. {
    2.   "code":200,
    3.   "data":[
    4.       {    "userType":"TOPIC",
    5.           "id":"$topicId1",
    6.           "name":"$topicName1",
    7.           "timestamp":"$ts1",
    8.           "lastMessage":{
    9.               "fromUuid":"$fromUuid1",
    10.               "fromAccount":"$fromAccount1",
    11.               "payload":"$payload1",
    12.               "sequence":"$sequence1"
    13.           }
    14.       }，
    15.       {
    16.           "userType":"TOPIC",
    17.           "id":"$topicId2",
    18.           "name":"$topicName2",
    19.           "timestamp":"$ts2",
    20.           "lastMessage":{
    21.               "fromUuid":"$fromUuid2",
    22.               "fromAccount":"$fromAccount2",
    23.               "payload":"$payload2",
    24.               "sequence":"$sequence2"
    25.           }
    26.       }，
    27.       {
    28.           "userType":"USER",
    29.           "id":"$uuid1",
    30.           "name":"$appAccount1",
    31.           "timestamp":"$ts3",
    32.           "lastMessage":{
    33.               "fromUuid":"$fromUuid3",
    34.               "fromAccount":"$fromAccount3",
    35.               "payload":"$payload3",
    36.               "sequence":"$sequence3"
    37.           }
    38.       }
    39.   ],
    40.   "message":"success"
    41. }

删除指定单聊会话

  • HTTP 请求
    1. curl "https://mimc.chat.xiaomi.net/api/contact/p2p/session?member=$member" -XDELETE
    2. -H "token:$token"
    3. -H "Content-Type: application/json"
  • JSON结果
    1. 同上，即与获取最近通讯列表的JSON结果一致。

删除指定群聊会话

  • HTTP 请求
    1. curl "https://mimc.chat.xiaomi.net/api/contact/p2t/session?topicId=$topicId" -XDELETE
    2. -H "token:$token"
    3. -H "Content-Type: application/json"
  • JSON结果
    1. 同上，即与获取最近通讯列表的JSON结果一致。