接口服务器的作用,服务器端接口说明

接口服务器的作用,服务器端接口说明

服务器端接口说明

服务端接口说明主要包含：鉴权说明、群组管理、成员管理、服务器端推送、获取历史记录等。

一、鉴权说明

1、Base URL

文档中所有被引用的地址都有如下Base URL：

:8883/2013-12-26

注意：

为了确保数据隐私，云通讯平台的REST API是通过HTTPS方式请求。

2、统一请求包头

业务URL格式

Base URL与业务URL相拼接为完整请求URL，其中{}内为可变参数。

参数func和funcdes根据接口填写；

参数appId为应用ID，可从官网创建获得；

参数SigParameter根据不同鉴权方式，做MD5加密后得到，参考后文的鉴权方式说明。

应用鉴权：

/Application/{appId}/{func}/{funcdes}?sig={SigParameter}

例如：

以应用鉴权的服务器端推送接口为例完整的URL为：:8883/2013-12-26/Application/{appId}/IM/PushMsg?sig={SigParameter}

HTTP标准包头字段(必填)

Accept:application/json;

Content-Type:application/json;charset=utf-8;

Content-Length:256;

Authorization:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX