• 业务对象
    • 用户信息
    • 群组信息
    • 事件通知
    • 聊天消息
    • 相关文档

    业务对象

    IM 在各类对外暴露的接口里，有一些公共的业务对象。本文档集中定义这些业务对象。

    这些业务对象都以 JSON 格式定义。在 Android SDK, iOS SDK 里的 API 暴露是相应语言的对象，不适用本文档。

    用户信息

    1. {
    2.     "username": "chicken",
    3.     "nickname": "Tom Chick",
    4.     "star": 2,
    5.     "avatar": "qiniu/image/uipreqfdsakl",     // 用户头像。存储的路径
    6.     "gender": 0,                              // 用户性别
    7.     "signature": "I am a ...",                // 签名
    8.     "region": "深圳",                          // 区域
    9.     “address”: "某街某号",                     // 详细地址
    10.     "mtime": "2015-03-03 11:00:00",           // 修改时间
    11.     "ctime": "2015-03-03 11:00:00",           // 创建时间
    12. }

    群组信息

    1. {
    2.     "gid": 13579,                            // 群ID，则服务器端创建
    3.     "owner_username": "tom",                 // 群主用户名
    4.     "group_name": "群名称",                   // 群名称。可任意指定
    5.     "group_desc": "群描述",                   // 群描述
    6.     "appkey": "dcf71ef5082057832bd44fbd",    // 应用Appkey
    7.     "level": 3,                              // 群组级别
    8.     "mtime": "2014-07-01 00:00:00",          // 更新时间
    9.     "ctime": "2014-07-01 00:00:00"           // 创建时间

    事件通知

    1. {
    2.     "event_type: "create_group",            // 事件类型
    3.     "from_username": "",                    // 发起事件的用户
    4.     “gid”: 13579,                           // 触发事件所在的群组（群组相关事件需要填写）
    5.     "to_username_list": ["eddie", "annie"], // 事件目标用户
    6.     "description": "the event is due to...",// 事件描述信息
    7.     "ctime": "2014-07-01 00:00:00"          // 事件创建时间
    8. }

    事件类型：

    • create_group
    • exit_group
    • add_members
    • remove_members

    聊天消息

    定义在单独的文档：IM 消息协议

    相关文档

    • JMessage 产品简介
    • Android SDK 开发指南
    • iOS SDK 开发指南
    • 资源下载