1.說(shuō)明：

教程屬于官方E聊SDK-簡(jiǎn)介(7)
進(jìn)入官網(wǎng)
進(jìn)入管理臺(tái)
SDK版本:v1.01
技術(shù)交流QQ群: 471688937

2.API文檔說(shuō)明：

為方便開(kāi)發(fā)者更好地理解E聊SDK以及更快地在此基礎(chǔ)上進(jìn)行二次開(kāi)發(fā)，E聊SDK提供了所用的基礎(chǔ)API說(shuō)明，在E聊SDK客戶端核心代碼EChatIMApis.ts 文件中，羅列了整個(gè)客戶端使用到的請(qǐng)求API, 詳細(xì)如下:

public static login: ApiCall<UserLoginForm, string> = new SocketIOApi<UserLoginForm, string>(
        Topic.CONNECTION.topic_name + "/" + Topic.CONNECTION.METHOD.AUTHORITY_REQUEST, "用戶登錄/請(qǐng)求授權(quán)", false);
    public static addOnlineMonitor:ApiCall<ClientOnlineMonitorForm, void> = new SocketIOApi<ClientOnlineMonitorForm, void>(
        Topic.APP_CLIENT.topic_name + "/" + Topic.APP_CLIENT.METHOD.ADD_ONLINE_MONITOR,
        "設(shè)置用戶的在線監(jiān)聽(tīng)", true);

    public static  sendMessage: ApiCall<MessageSendForm, void> = new HttpApi<MessageSendForm, void>(
        Topic.APP_UPSTREAM_MESSAGE.base_uri + "/" + Topic.APP_UPSTREAM_MESSAGE.METHOD.SEND,
        "APP跟IM用戶發(fā)送消息", "POST",true);
    // user
    public static userAdd:ApiCall<UserAddForm, void> = new HttpApi<UserAddForm, void>(
        Topic.APP_USER.base_uri + "/" + Topic.APP_USER.METHOD.ADD,
        "添加用戶", "POST", true);
    public static userUpdate:ApiCall<UserUpdateForm, void> = new HttpApi<UserUpdateForm, void>(
        Topic.APP_USER.base_uri + "/" + Topic.APP_USER.METHOD.UPDATE,
        "更新用戶", "POST", true);
    public static userList:ApiCall<UserListForm, Array<UserListDTO>> = new HttpApi<UserListForm, Array<UserListDTO>>(
        Topic.APP_USER.base_uri + "/" + Topic.APP_USER.METHOD.LIST,
        "用戶列表", "POST", true);
    public static userGet:ApiCall<UserGetForm, UserGetDTO> = new HttpApi<UserGetForm, UserGetDTO>(
        Topic.APP_USER.base_uri + "/" + Topic.APP_USER.METHOD.GET,
        "獲取用戶信息", "POST", true);
    public static userUpdateToken:ApiCall<UserUpdateTokenForm, void> = new HttpApi<UserUpdateTokenForm, void>(
        Topic.APP_USER.base_uri + "/" + Topic.APP_USER.METHOD.UPDATE_TOKEN,
        "更新用戶Token", "POST", true);
    public static userRefreshToken:ApiCall<UserRefreshTokenForm, UserRefreshTokenDTO> = new HttpApi<UserRefreshTokenForm, UserRefreshTokenDTO>(
        Topic.APP_USER.base_uri + "/" + Topic.APP_USER.METHOD.REFRESH_TOKEN,
        "刷新用戶Token", "POST", true);
    // history message
    public static historyListMessage:ApiCall<HistoryListForm, Array<MessageListDTO>> = new HttpApi<HistoryListForm, Array<MessageListDTO>>(
        Topic.APP_HISTORY_MESSAGE.base_uri + "/" + Topic.APP_HISTORY_MESSAGE.METHOD.LIST_MESSAGE,
        "獲取用戶歷史信息", "POST", true);
    public static historyListSession:ApiCall<HistoryListSessionForm, Array<HistorySessionDTO>> = new HttpApi<HistoryListSessionForm, Array<HistorySessionDTO>>(
        Topic.APP_HISTORY_MESSAGE.base_uri + "/" + Topic.APP_HISTORY_MESSAGE.METHOD.LIST_SESSION,
        "獲取用戶歷史會(huì)話", "POST", true);

    // user relation
    public static addFriend:ApiCall<UserFriendAddForm, void> = new HttpApi<UserFriendAddForm, void>(
        Topic.APP_USER_RELATION.base_uri + "/" + Topic.APP_USER_RELATION.METHOD.ADD_FRIEND,
        "添加朋友", "POST", true);
    public static delFriend:ApiCall<UserFriendDelForm, void> = new HttpApi<UserFriendDelForm, void>(
        Topic.APP_USER_RELATION.base_uri + "/" + Topic.APP_USER_RELATION.METHOD.DEL_FRIEND,
        "刪除朋友", "POST", true);
    public static listFriends:ApiCall<UserFriendListForm, UserFriendListDTO> = new HttpApi<UserFriendListForm, UserFriendListDTO>(
        Topic.APP_USER_RELATION.base_uri + "/" + Topic.APP_USER_RELATION.METHOD.LIST_FRIENDS,
        "獲取朋友列表", "POST", true);
    public static getFriend:ApiCall<UserFriendGetForm, UserFriendGetDTO> = new HttpApi<UserFriendGetForm, UserFriendGetDTO>(
        Topic.APP_USER_RELATION.base_uri + "/" + Topic.APP_USER_RELATION.METHOD.GET_FRIEND,
        "獲取好友", "POST", true);
    public static modifyBlacklistForbid:ApiCall<UserBlacklistModifyForm, void> = new HttpApi<UserBlacklistModifyForm, void>(
        Topic.APP_USER_RELATION.base_uri + "/" + Topic.APP_USER_RELATION.METHOD.MODIFY_BLACKLIST_FORBID,
        "修改朋友黑名單/禁言", "POST", true);
    public static listBlackListForbid:ApiCall<UserBlackForbidListForm, UserBlackForbidListDTO> = new HttpApi<UserBlackForbidListForm, UserBlackForbidListDTO>(
        Topic.APP_USER_RELATION.base_uri + "/" + Topic.APP_USER_RELATION.METHOD.LIST_BLACKLIST_FORBID,
        "獲取朋友黑名單/禁言列表", "POST", true);
    public static modifyAlias:ApiCall<UserFriendAliasForm, void> = new HttpApi<UserFriendAliasForm, void>(
        Topic.APP_USER_RELATION.base_uri + "/" + Topic.APP_USER_RELATION.METHOD.MODIFY_ALIAS,
        "修改朋友別名", "POST", true);

    // room
    public static addRoom:ApiCall<RoomAddForm, number> = new HttpApi<RoomAddForm, number>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.ADD,
        "添加群", "POST", true);
    public static updateRoom:ApiCall<RoomUpdateForm, void> = new HttpApi<RoomUpdateForm, void>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.UPDATE,
        "更新群", "POST", true);
    public static listRoom:ApiCall<RoomListForm, Array<RoomListDTO>> = new HttpApi<RoomListForm, Array<RoomListDTO>>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.LIST,
        "獲取群列表", "POST", true);
    public static listRoomJoin:ApiCall<RoomListJoinForm, Array<RoomListDTO>> = new HttpApi<RoomListJoinForm, Array<RoomListDTO>>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.LIST_JOIN,
        "獲取用戶加入的群", "POST", true);
    public static delRoom:ApiCall<RoomDelForm, void> = new HttpApi<RoomDelForm, void>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.DEL,
        "刪除群", "POST", true);
    public static getRoom:ApiCall<RoomGetForm, RoomGetDTO> = new HttpApi<RoomGetForm, RoomGetDTO>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.GET,
        "獲取單個(gè)群信息", "POST", true);

    public static listRoomMember:ApiCall<RoomListForm, Array<RoomDetailListDTO>> = new HttpApi<RoomListForm, Array<RoomDetailListDTO>>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.LIST_MEMBER,
        "列出群成員", "POST", true);
    public static addRoomMember:ApiCall<RoomAddUserForm, void> = new HttpApi<RoomAddUserForm, void>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.ADD_USER,
        "添加群成員", "POST", true);
    public static delRoomMember:ApiCall<RoomDelUserForm, void> = new HttpApi<RoomDelUserForm, void>(
        Topic.APP_ROOM.base_uri + "/" + Topic.APP_ROOM.METHOD.DEL_USER,
        "刪除群成員", "POST", true);

    public static userOnline:ApiCall<ClientUserOnlineForm, void> = new HttpApi<ClientUserOnlineForm, void>(
        Topic.APP_CLIENT.base_uri + "/" + Topic.APP_CLIENT.METHOD.USER_ONLINE,
        "列出用戶的在線狀態(tài)", "POST", true);

所有的API接口路徑都定義到一個(gè)Topic 類下，使用Topic 類下的topic_name + '/' + METHOD，能快速在API文檔定位到詳細(xì)接口說(shuō)明。

export class Topic {
    static prefix = 'topic.';
    static httpPrefix = '/v1/';

    static CONNECTION = class {
        static topic_name = Topic.prefix + "connection";
        static base_uri = Topic.httpPrefix + "connection";

        static METHOD = class {
            static AUTHORITY_REQUEST = "authority_request";
        }
    };

    static APP_USER = class {
        static topic_name = Topic.prefix + "user";
        static base_uri = Topic.httpPrefix + "user";
        static METHOD = class {
            static ADD = "add";
            static UPDATE = "update";
            static LIST = "list";
            static GET = "get";
            static UPDATE_TOKEN = "update_token";
            static REFRESH_TOKEN = "refresh_token";
        }
    };

    // 通過(guò)服務(wù)器向客戶端發(fā)送消息的prefix
    static APP_UPSTREAM_MESSAGE = class {
        static topic_name = Topic.prefix + "upstream_message";
        static base_uri = Topic.httpPrefix + "upstream_message";

        static METHOD = class {
            static SEND = "send";
            static BATCH_SEND = "batch_send";
            static SEND_ACK_TO_SERVER = "sendack_toserver";
        }
    };


    // 服務(wù)器向客戶端發(fā)送消息的prefix
    static APP_DOWNSTREAM_MESSAGE = class {
        static topic_name = Topic.prefix + "downstream_message";
        static base_uri = Topic.httpPrefix + "downstream_message";
        static METHOD = class {
            static SEND_MESSAGE_TO_CLIENT = "sendmessage_toclient";
            static SEND_EVENT_TO_CLIENT = "sendevent_toclient";
        }
    };


    static APP_CLIENT = class {
        static topic_name = Topic.prefix + "client";
        static base_uri = Topic.httpPrefix + "client";
        static METHOD = class {
            static USER_ONLINE = "user_online"; // 列出用戶的在線狀態(tài)
            static ADD_ONLINE_MONITOR = "add_online_monitor";// 設(shè)置用戶的在線監(jiān)聽(tīng)
        }
    };

    static APP_ROOM = class {
        static topic_name = Topic.prefix + "room";
        static base_uri = Topic.httpPrefix + "room";
        static METHOD = class {
            static ADD = "add"; // 添加群
            static UPDATE = "update"; // 更新群信息
            static LIST = "list"; // 列出群信息
            static DEL = "del"; // 刪除群
            static GET = "get"; // 獲取單個(gè)群信息
            static LIST_JOIN = "list_join"; // 列出當(dāng)前用戶加入的群
            static LIST_MEMBER = "list_member"; // 列出群信息/群成員
            static ADD_USER = "add_user"; // 添加群用戶
            static DEL_USER = "del_user"; // 刪除群用戶
        }
    };


    static APP_USER_RELATION = class {
        static topic_name = Topic.prefix + "user_relation";
        static base_uri = Topic.httpPrefix + "user_relation";
        static METHOD = class {
            static ADD_FRIEND = "add_friend"; // 添加好友
            static DEL_FRIEND = "del_friend"; // 刪除好友
            static LIST_FRIENDS = "list_friends"; // 列出好友列表
            static GET_FRIEND = "get_friend"; // 獲取好友
            static MODIFY_BLACKLIST_FORBID = "add_blacklist";// 添加/移除黑名單, 添加/移除黑禁言
            static LIST_BLACKLIST_FORBID = "list_blacklists"; // 列出黑名單, 禁言列表
            static MODIFY_ALIAS = "modify_alias";// 修改IM好友別名
        }
    };

    // 通過(guò)服務(wù)器向客戶端發(fā)送消息的prefix
    static APP_HISTORY_MESSAGE = class {
        static topic_name = Topic.prefix + "history";
        static base_uri = Topic.httpPrefix + "history";
        static METHOD = class {
            static LIST_MESSAGE = "list_message"; // 列出歷史消息
            static LIST_SESSION = "list_session"; // 列出用戶歷史會(huì)話列表
        }
    }
}

E聊SDK同時(shí)支持以socket.io 方式的通訊(使用SocketIOApi)和HttpApi方式的通訊(使用HttpApi), 使用的HttpApi接口請(qǐng)求信息與返回信息詳細(xì)列表如下, 為保證實(shí)時(shí)信及減少錯(cuò)漏, Http API文檔使用swagger-ui 文檔直接生成(請(qǐng)使用Topic 類下的topic_name + '/' + METHOD進(jìn)行快捷搜索)。
詳見(jiàn): HTTP API文檔