# 使用前准备
### 一、名词解析
1. `开放平台`: 指由易联云公司所拥有并且经营的[https://dev.10ss.net](https://dev.10ss.net) 网站及相关页面,简称`开放平台`。
2. `开发者`: 指按照开放平台流程经注册、登录,通过技术文档进行软件开发的自然人、法人或者组织。开发者通过开放平台提供的技术文档进行软件开发,服务自身或者其他客户。
3. `用户`: 指在易联云上注册的自然人、法人或组织结构拥有者,具有对易联云打印机的管理权限。
4. `应用`: 指由开发者通过开放平台所开发的应用程序或者软件服务。
5. `应用ID`(client_id)& `应用密钥`(client_secret):易联云应用的唯一标识码和标识密钥,在创建应用后获得。用来鉴权、验证、API调用等。
6. `终端号`(machine_code)& `终端密钥`(msign): 易联云打印机上的唯一标识码和标识密钥。需要注意的是,商户和打印机是`一对多`的关系,即一个商户可以拥有和管理多台云打印机。
7. `API`(Application Programming Interface): 开放平台为第三方应用接入提供的编程接口。具体接口说明,参见[API文档](API文档.md)。
### 二、应用类型及区别
1. `自有型应用`:用户作为开发者接入并创建自有型应用,无需入驻易联云服务市场,自有型应用只能控制该用户账号下的打印机设备,不支持其它用户的打印机设备授权,需代码开发。
2. `开放型应用`:指企业或第三方系统作为开发者接入并创建开放型应用,可以入驻易联云服务市场,开放型应用作为软件服务推广给易联云用户使用,可以授权多个用户,用户需要通过Oauth2.0的授权码模式进行打印机设备授权,需要代码开发。
### 三、创建应用的详细流程
1. 首先用浏览器打开开放平台网址:[https://dev.10ss.net](https://dev.10ss.net),点击右上角的【登录】按钮登录。
![首页](https://img.kancloud.cn/c2/6a/c26af9ffc8f6b44821e7902a9d6b8201_1354x908.png)
2. 登录后需完善信息认证。
![完善信息a](https://img.kancloud.cn/8d/24/8d24fe28645aec4dc459f13cd3c94795_464x111.png)
![完善信息b](https://img.kancloud.cn/ea/4b/ea4ba56a5c7983023295734bc6bce569_1169x893.png)
3. 左侧菜单栏应用列表中,点击【+】选项创建应用。
![应用创建](https://img.kancloud.cn/94/02/940282110479dfe9f3e018b0d8e57431_1164x735.png)
4. 应用详情信息获取应用ID(client_id)& 应用密钥(client_secret),进行API对接。
![应用详情](https://img.kancloud.cn/22/16/221605b3eaaa5ff4ca99e4c597f74bba_1165x706.png)
- 使用前准备【必看】
- 开发者服务指引【必看】
- 接口更新动态
- 2024年1月
- 2023年11月
- 2023年10月
- 2023年9月
- 2023年6月
- 开发文档【必看】
- 调用协议【必看】
- 授权文档【必接】
- 自有型应用
- 开放型应用(OAuth2.0授权码模式)
- 开放型应用(扫码授权模式)
- SDK使用说明
- API文档【按需对接】
- 设备文档
- 设备绑定
- 设备解绑或取消授权
- 状态获取
- 离线或重启控制
- 打印控制
- logo控制
- 音效音量控制
- 内置语音控制
- 打印宽度获取
- 型号版本获取
- 接单拒单控制
- 打印文档
- 文本打印
- 图片打印
- 面单文档
- 面单生成并打印
- 面单取消
- 打印队列文档
- 订单状态获取(单订单)
- 订单列表获取
- 订单取消打印(单订单)
- 订单取消打印(全量)
- 订单重打(单订单)
- 应用设置文档
- 推送地址设置
- K8支付设置文档
- 推送开关设置
- 关键词设置
- 高级设置
- 打印消息推送
- 打印消息推送说明
- 打印完成推送
- 终端状态推送
- 接单拒单推送
- K8扫码信息推送
- 产品介绍
- 授权说明
- 消息推送
- http/https推送方式
- 签名验证规则
- 解密规则
- 指令说明
- 验签解密示例
- 打印指令文档
- 指令文档说明
- 指令集
- 常见问题
- 错误码说明
- FAQ