@heavysheep 2017-10-18T15:45:47.000000Z 字数 8086 阅读 1015

直播api

未分类

公共聊天

接口：send_message
说明：基本维持原来的数据类型，砍掉了team_id等，增加live_id。
示例数据：

test_data = {
    "fromUserId": "52c3f1065f94ed491327cd88", # 用户id
    "live_id": "00009028b5f68419ab9c40a1b0e138b6dcbee3f5",  # live_id
    "chatroom_id": json.dumps(["00009097f7b32c02669748d6a9a52e2f435be845"]),  # json形式chatroom_id，列表格式
    "message_class": "interaction",  # 数据类型，后续不需要存的数据可直接约定在此
    "message_type": "TxtMsg",
    "site_id": "2432383526fd39e5ddf84a2588292ad5ac494e25",
    "content": json.dumps({"content": {"id": "52c3f1065f94ed491327cd88",
                                       "name": "ZGlhbnhpbmxpdQ==",
                                       "img": "55c86bf5b4b706624aed889c",
                                       "msg": "MTIzMTIz",
                                       "send_time": 1503979247842,
                                       "team_id": "26235843f9373aa65e6144a8b308d234cecc8463",
                                       "msg_type": "chat"}})
    # json形式content，双层嵌套

此时会向md5哈希后的chatroom_id即423401501e5893b32dc9d2bac0d5f165以from_user_id发送消息类型为RC:TxtMsg的json化数据:
向融云发送的数据：

{'fromUserId': '52c3f1065f94ed491327cd88', 
'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
u'name': u'ZGlhbnhpbmxpdQ==', 
u'img': u'55c86bf5b4b706624aed889c', 
'site_id': '2432383526fd39e5ddf84a2588292ad5ac494e25',
'message_class': 'interaction',
'state': 0,
u'send_time': 1503979247842L,
u'msg': u'MTIzMTIz',
u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463', 
'message_type': 'TxtMsg', 
u'id': u'52c3f1065f94ed491327cd88',
u'msg_type': u'chat'}

接口返回

{u'code': 200}  # 当返回200时一切正常，返回非200情况为融云错误，其他错误返回svr_send_message开头的字符串

教师操作

接口：send_message
说明：按要求原来的数据类型，将content字段提至外层，砍掉了team_id等，live_time等，增加live_id。
示例数据：

test_data = {
    "fromUserId": "52c3f1065f94ed491327cd88",
    "chatroom_id": json.dumps(["00009097f7b32c02669748d6a9a52e2f435be845"]),
    "message_class": "ppt_single",
    "message_type": "TxtMsg",
    "live_id": "00009028b5f68419ab9c40a1b0e138b6dcbee3f5",
    "site_id": "2432383526fd39e5ddf84a2588292ad5ac494e25",
    "id": "52c3f1065f94ed491327cd88",
    "index": 3,
    "name": "ZGlhbnhpbmxpdQ==",
    "msg": "MTIzMTIz",
    "url": "123456",
    "count": 6,
    "send_time": 1503979247842,
    "msg_type": "chat"
}

此时会向md5哈希后的chatroom_id即423401501e5893b32dc9d2bac0d5f165以from_user_id发送消息类型为RC:ppt_single的json化数据:
向融云发送的数据

{'fromUserId': '52c3f1065f94ed491327cd88', 
'msg_id': '59e7002ee3ae9a31f42e7203', 
'msg_type': 'chat', 
'chapter_resource_id': u'83029656296ac93502e146d3bd18640249125f9b', 'live_time': 429063.37, 
'message_class': 'ppt_single', 
'id': '52c3f1065f94ed491327cd88',
'count': 6, 'index': 3, 
'url': '123456', 
'message_type': 'TxtMsg'}

接口返回

{u'code': 200}  # 当返回200时一切正常，返回非200情况为融云错误，其他错误返回svr_send_message开头的字符串

获取公聊数据

接口： message_list
说明：基本维持原来的数据类型，因为业务和结构变动，支持参数变少，目前支持的筛选条件message_class、page、limit和sort，默认时间正序索引
示例数据

test_data = {
    "toUserId": json.dumps(["00009097f7b32c02669748d6a9a52e2f435be845"]),  # 未哈希过的chatroom_id
    "message_class": json.dumps(["interaction"]),  # json化的列表，其中为所需要的类型
    "page": 1,  # 页数，从1开始，不填默认为1
    "limit": 10  # 页数，不填默认为20
    "sort": -1  # 反向排序，不需要可以不填
}

则接口返回

[
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
        u'name': u'ZGlhbnhpbmxpdQ==',
        u'msg_type': u'chat',
        u'state': 0,
        u'message_type': u'TxtMsg',
        u'live_time': 0,
        u'site_id': u'2432383526fd39e5ddf84a2588292ad5ac494e25',
        u'message_class': u'interaction',
        u'img': u'55c86bf5b4b706624aed889c',
        u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463',
        u'send_time': 1503979247842L,
        u'msg': u'MTIzMTIz',
        u'json_content': [
            u'{
                "content": {
                    "name": "ZGlhbnhpbmxpdQ==",
                    "img": "55c86bf5b4b706624aed889c",
                    "team_id": "26235843f9373aa65e6144a8b308d234cecc8463",
                    "send_time": 1503979247842,
                    "msg": "MTIzMTIz",
                    "id": "52c3f1065f94ed491327cd88",
                    "msg_type": "chat"
                }
            }'
        ],
        u'id': u'52c3f1065f94ed491327cd88',
        u'add_time': datetime.datetime(2017,10,16,17,46,42,804000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
        u'name': u'ZGlhbnhpbmxpdQ==',
        u'img': u'55c86bf5b4b706624aed889c',
        u'json_content': [
            u'{
                "content": {
                    "name": "ZGlhbnhpbmxpdQ==",
                    "img": "55c86bf5b4b706624aed889c",
                    "team_id": "26235843f9373aa65e6144a8b308d234cecc8463",
                    "send_time": 1503979247842,
                    "msg": "MTIzMTIz",
                    "id": "52c3f1065f94ed491327cd88",
                    "msg_type": "chat"
                }
            }'
        ],
        u'live_time': 0,
        u'site_id': u'2432383526fd39e5ddf84a2588292ad5ac494e25',
        u'message_class': u'interaction',
        u'state': 0,
        u'send_time': 1503979247842L,
        u'msg': u'MTIzMTIz',
        u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'msg_type': u'chat',
        u'add_time': datetime.datetime(2017,10,16,18,0,40,56000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
        u'name': u'ZGlhbnhpbmxpdQ==',
        u'img': u'55c86bf5b4b706624aed889c',
        u'live_time': 0,
        u'site_id': u'2432383526fd39e5ddf84a2588292ad5ac494e25',
        u'message_class': u'interaction',
        u'state': 0,
        u'send_time': 1503979247842L,
        u'msg': u'MTIzMTIz',
        u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'msg_type': u'chat',
        u'add_time': datetime.datetime(2017,10,16,18,1,25,162000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
        u'name': u'ZGlhbnhpbmxpdQ==',
        u'img': u'55c86bf5b4b706624aed889c',
        u'live_time': 0,
        u'site_id': u'2432383526fd39e5ddf84a2588292ad5ac494e25',
        u'message_class': u'interaction',
        u'state': 0,
        u'send_time': 1503979247842L,
        u'msg': u'MTIzMTIz',
        u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'msg_type': u'chat',
        u'add_time': datetime.datetime(2017,10,18,14,55,8,357000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
        u'name': u'ZGlhbnhpbmxpdQ==',
        u'img': u'55c86bf5b4b706624aed889c',
        u'live_time': 0,
        u'site_id': u'2432383526fd39e5ddf84a2588292ad5ac494e25',
        u'message_class': u'interaction',
        u'state': 0,
        u'send_time': 1503979247842L,
        u'msg': u'MTIzMTIz',
        u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'msg_type': u'chat',
        u'add_time': datetime.datetime(2017,10,18,14,59,38,355000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
        u'name': u'ZGlhbnhpbmxpdQ==',
        u'img': u'55c86bf5b4b706624aed889c',
        u'site_id': u'2432383526fd39e5ddf84a2588292ad5ac494e25',
        u'message_class': u'interaction',
        u'state': 0,
        u'send_time': 1503979247842L,
        u'msg': u'MTIzMTIz',
        u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'msg_type': u'chat',
        u'add_time': datetime.datetime(2017,10,18,15,19,48,333000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chatroom_id': u'00009097f7b32c02669748d6a9a52e2f435be845',
        u'name': u'ZGlhbnhpbmxpdQ==',
        u'img': u'55c86bf5b4b706624aed889c',
        u'site_id': u'2432383526fd39e5ddf84a2588292ad5ac494e25',
        u'message_class': u'interaction',
        u'state': 0,
        u'send_time': 1503979247842L,
        u'msg': u'MTIzMTIz',
        u'team_id': u'26235843f9373aa65e6144a8b308d234cecc8463',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'msg_type': u'chat',
        u'add_time': datetime.datetime(2017,10,18,15,22,57,918000)
    }
]

获取所有教师操作数据

接口： live_comm_list
说明：基本维持原来的数据类型，因为业务和结构变动，支持参数变少，目前仅支持筛选条件message_class，默认时间正序排序
示例数据

test_data = {
    "toUserId": json.dumps(["00009097f7b32c02669748d6a9a52e2f435be845"]),
    "message_class": json.dumps(["ppt_single"]),
}

则接口返回：

[
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chapter_resource_id': u'83029656296ac93502e146d3bd18640249125f9b',
        u'msg_id': u'59e48237e3ae9a3960a01aa9',
        u'msg_type': u'chat',
        u'count': 6,
        u'url': u'123456',
        u'index': 3,
        u'live_time': 265744.5,
        u'message_class': u'ppt_single',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'add_time': datetime.datetime(2017,10,16,17,56,8,720000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chapter_resource_id': u'83029656296ac93502e146d3bd18640249125f9b',
        u'msg_id': u'59e6fed4e3ae9a2958398200',
        u'msg_type': u'chat',
        u'count': 6,
        u'url': u'123456',
        u'index': 3,
        u'live_time': 428717.39,
        u'message_class': u'ppt_single',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'add_time': datetime.datetime(2017,10,18,15,12,21,487000)
    },
    {
        u'fromUserId': u'52c3f1065f94ed491327cd88',
        u'chapter_resource_id': u'83029656296ac93502e146d3bd18640249125f9b',
        u'msg_id': u'59e7002ee3ae9a31f42e7203',
        u'msg_type': u'chat',
        u'count': 6,
        u'url': u'123456',
        u'index': 3,
        u'live_time': 429063.37,
        u'message_class': u'ppt_single',
        u'message_type': u'TxtMsg',
        u'id': u'52c3f1065f94ed491327cd88',
        u'add_time': datetime.datetime(2017,10,18,15,18,7,577000)
    }
]

其他接口不知道是否被废弃，我还没进行测试，有什么需要随时跟我说