E聊SDK-簡介(7): API文檔
1.說明：
教程屬於官方E聊SDK-簡介(7)
進入官網
進入管理臺
SDK版本:v1.01
技術交流QQ羣: 471688937服務器
2.API文檔說明：
爲方便開發者更好地理解E聊SDK以及更快地在此基礎上進行二次開發，E聊SDK提供了所用的基礎API說明，在E聊SDK客戶端核心代碼EChatIMApis.ts 文件中，羅列了整個客戶端使用到的請求API, 詳細以下:session
public static login: ApiCall<UserLoginForm, string> = new SocketIOApi<UserLoginForm, string>(
Topic.CONNECTION.topic_name + "/" + Topic.CONNECTION.METHOD.AUTHORITY_REQUEST, "用戶登陸/請求受權", false);
public static addOnlineMonitor:ApiCall<ClientOnlineMonitorForm, void> = new SocketIOApi<ClientOnlineMonitorForm, void>(
Topic.APP_CLIENT.topic_name + "/" + Topic.APP_CLIENT.METHOD.ADD_ONLINE_MONITOR,
"設置用戶的在線監聽", 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用戶發送消息", "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,
"獲取用戶歷史會話", "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,
"獲取單個羣信息", "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,
"列出用戶的在線狀態", "POST", true);
全部的API接口路徑都定義到一個Topic 類下，使用Topic 類下的topic_name + '/' + METHOD，能快速在API文檔定位到詳細接口說明。socket
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";
}
};
// 經過服務器向客戶端發送消息的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";
}
};
// 服務器向客戶端發送消息的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"; // 列出用戶的在線狀態
static ADD_ONLINE_MONITOR = "add_online_monitor";// 設置用戶的在線監聽
}
};
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"; // 獲取單個羣信息
static LIST_JOIN = "list_join"; // 列出當前用戶加入的羣
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好友別名
}
};
// 經過服務器向客戶端發送消息的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"; // 列出用戶歷史會話列表
}
}
}
E聊SDK同時支持以socket.io 方式的通信(使用SocketIOApi)和HttpApi方式的通信(使用HttpApi), 使用的HttpApi接口請求信息與返回信息詳細列表以下, 爲保證明時信及減小錯漏, Http API文檔使用swagger-ui 文檔直接生成(請使用Topic 類下的topic_name + '/' + METHOD進行快捷搜索)。
詳見: HTTP API文檔ui
相關文章
- 1. E聊SDK-簡介(1)--介紹
- 2. E聊SDK-簡介(1): 介紹
- 3. E聊SDK-簡介(3): 管理平臺使用
- 4. (六)API文檔介紹
- 5. 微軟的Live SDK各個API簡介
- 6. Guidance SDK文檔
- 7. 中文Appium API 文檔
- 8. 中文 Appium API 文檔
- 9. E-R圖簡介
- 10. 地圖API文檔
- 更多相關文章...
- • WSDL 文檔 - WSDL 教程
- • XSL-FO 文檔 - XSL-FO 教程
- • Github 簡明教程
- • Java Agent入門實戰（一）-Instrumentation介紹與使用
相關標籤/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
最新文章
歡迎關注本站公眾號,獲取更多信息
相關文章
- 1. E聊SDK-簡介(1)--介紹
- 2. E聊SDK-簡介(1): 介紹
- 3. E聊SDK-簡介(3): 管理平臺使用
- 4. (六)API文檔介紹
- 5. 微軟的Live SDK各個API簡介
- 6. Guidance SDK文檔
- 7. 中文Appium API 文檔
- 8. 中文 Appium API 文檔
- 9. E-R圖簡介
- 10. 地圖API文檔