API 定義

下面列出目前第三方應(yīng)用可以使用的 API。

chat/getChatGroups

此接口用于獲取系統(tǒng)中的討論組列表。

• 請(qǐng)求方式：GET  ；
• 模塊名稱：chat  ；
• 方法名稱：getChatGroups  ；
• 參數(shù)：無(wú)；
• 返回值：JSON 對(duì)象，該對(duì)象屬性定義如下：

下面為一個(gè)示例請(qǐng)求地址：

https://myxxb.com/api.php?m=chat&f=getChatGroups&code=myAppCode&token=f5633c34c0c551a16c1d63bceb38d6a8

正常情況下返回值如下：

{
    "result": "success",
    "data": {
        "30683aea-7a1f-4ec8-a6d6-834e0310fd7d": "第四期項(xiàng)目討論",
        "81c6ba89-00ab-4431-8e47-063556ae4886": "研發(fā)部",
        "64da14c3-c07a-45af-9c61-4e638de4af26": "公司總?cè)?
    }
}

chat/getChatUsers

此接口用于獲取指定討論組中的成員信息或者獲取系統(tǒng)中全部成員信息。

• 請(qǐng)求方式：GET  ；
• 模塊名稱：chat  ；
• 方法名稱：getChatUsers  ；
• 參數(shù)：
• gid  ：設(shè)置為要獲取用戶成員信息的討論組的全局唯一 標(biāo)識(shí)字符串（GID），如果留空，則請(qǐng)求會(huì)返回系統(tǒng)所有成員信息。
• 返回值：JSON 對(duì)象，該對(duì)象屬性定義如下：

下面為獲取 GID 為 '30683aea-7a1f-4ec8-a6d6-834e0310fd7d'  的討論組成員信息的示例請(qǐng)求地址：

https://myxxb.com/api.php?m=chat&f=getChatUsers&gid=30683aea-7a1f-4ec8-a6d6-834e0310fd7d&code=myAppCode&token=f5633c34c0c551a16c1d63bceb38d6a8

正常情況下返回值如下：

{
    "result": "success",
    "data": {
        "1": "管理員",
        "3": "張三",
        "4": "李四"
    }
}

notifyMSG

此接口用于向指定的討論組推送通知消息。

• 請(qǐng)求方式：POST  ；
• 模塊名稱：chat  ；
• 方法名稱：notifyMSG  ；
• 參數(shù)：無(wú)；
• 返回值：JSON 對(duì)象，該對(duì)象屬性定義如下：

將要推送的通知消息對(duì)象轉(zhuǎn)換為 JSON 字符串形式，然后使用 data  域通過(guò) POST 請(qǐng)求發(fā)送到服務(wù)器。

一個(gè)通知消息對(duì)象擁有如下屬性：

通知的  操作對(duì)象包含如下屬性：

發(fā)送方信息對(duì)象包容如下屬性：

下面為一個(gè)發(fā)送通知消息的示例 POST 請(qǐng)求地址：

https://myxxb.com/api.php?m=chat&f=notifyMSG&code=myAppCode&token=f5633c34c0c551a16c1d63bceb38d6a8

下面為使用 JavaScript  Fetch API 發(fā)起請(qǐng)求示例代碼：

const notifycationData = {
    receiver: 'group',
    gid: 'f3de9ff9-dcb4-49de-915b-377ee9143418',
    title: '測(cè)試通知消息',
    subTitle: '測(cè)試通知消息副標(biāo)題',
    content: '**測(cè)試消息**內(nèi)容',
    contentType: 'text',
    url: 'http://xuan.im',
    actions: [
        {
            type: 'danger',
            label: '更新日志',
            url: 'https://xuan.im/page/changelogs.html'
        }, {
            type: 'normal',
            label: '下載地址',
            url: 'http://xuan.im/page/download.html'
        }
    ],
    sender: {
        avatar: 'https://avatars2.githubusercontent.com/u/472425?s=460&v=4',
        name: 'Catouse',
        id: 'catouse'
    }
};
const formData = new FormData();
formData.append('data', JSON.stringify(data));
const postUrl = 'https://myxxb.com/api.php?m=chat&f=notifyMSG&code=myAppCode&token=f5633c34c0c551a16c1d63bceb38d6a8';
fetch(postUrl, {
    method: 'POST',
    body: formData
}).then(r => {
    return r.json();
}).then(response => {
    if (response && response.result === 'success') {
        console.log('操作成功');
    }
});

正常情況下返回值如下：

{
    "result": "success"
}