• 最近通讯列表
    • 参数列表
    • 获取最近通讯列表
    • 删除指定单聊会话
    • 删除指定群聊会话

    最近通讯列表

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