API调用协议说明: 1.概述 易联云云打印开放平台通讯协议是一个无状态的、轻量级的基于HTTP的 RPC 通讯协议。 2.设计原则 本协议只定义数据交互的格式与方式,不关注数据的传输方式,不关注认证方式,不关注接口版本控制。 3.RPC 调用 开放平台的 RPC 调用主要用于客户端应用主动获取开放平台服务器端数据信息,是通过客户端应用向开放平台的API服务器发送HTTP POST请求对象,而服务器返回响应对象实现的。 **`Content-Type:application/x-www-form-urlencoded`**; 如无特殊说明,接口的所有参数值均为UTF-8编码 3.1.1 公共参数说明: |名 称|类 型|描 述| |----|----|----| |client_id|string|开发者的应用ID,在[开放平台](https://dev.10ss.net)创建应用时获得| |access_token|string|访问令牌| |sign|string|签名 详见API文档列表-[接口签名](apiprotocol.md)| |timestamp|int|当前服务器时间戳(10位)| |id|string|UUID4 详见API文档列表-[UUID4](apiprotocol.md)| 3.1.2 接口签名: 将client_id+timestamp+client_secret(三个参数只需要值),再做md5,得出字符串转成小写即为sign。client_secret为应用密钥,在[开放平台](https://dev.10ss.net)创建应用后获得 。 为了防止API调用过程中被黑客恶意篡改,调用任何一个API都需要携带签名参数,API服务端会根据请求参数,对签名进行验证,签名不合法的请求将会被拒绝。 3.1.3 UUID4: UUID4,用来唯一标记此次调用,响应对象中会包含相同的id。UUID以36字节的字符串表示, 示例如下: 3F2504E0-4F89-11D3-9A0C-0305E82C3301 3.1.4 关于境外HOST说明:需要把国内的`https://open-api.10ss.net`,替换成`https://open-api-os.10ss.net`,但是接口方法名不变! 示例如下: 国内:`https://open-api.10ss.net/oauth/oauth` 境外:`https://open-api-os.10ss.net/oauth/oauth`