# 新手指南
[TOC=2,3]
## **第一步:入驻成为开发者**
首先填写申请表单成为开放平台开发者,点击 [申请加入](http://dev.10ss.net/join#join) (`http://dev.10ss.net/join#join`) 填写对应的信息。如果*未登录*,请登录账号后方可申请加入,请直接使用易联云账号登录开放平台,完成开发者入驻。
* * * * *
*如下是申请样图(个人申请):*
![申请样图](https://box.kancloud.cn/dbda497e22a40ff7926ba17f723ba3ac_1724x759.png)
* * * * *
申请中主要分为两种开发者类型:
1.个人开发者
2.企业商户开发团体
* * * * *
*如下是申请样图(企业商户):*
![企业商户申请图样](https://box.kancloud.cn/257f5b0f0a236e0be32430fa3d60d137_1724x1057.png)
* * * * *
提交入驻申请之后,我们会在1-3个工作日完成开发者身份审核。如果您是第三方服务商,想为商户提供软件服务,请在开放平台注册账号,完成第三方服务商开发者入驻。
## **第二步:创建应用**
申请入驻成功后就可以进入开放平台开始使用了,入口点击[开始使用开放平台](http://dev.10ss.net/admin)(`http://dev.10ss.net/admin`)。
查看我的申请 --> 查看详情 --> 添加App应用
* * * * *
如图进入app申请表单:
![申请创建app填写表单图样](https://box.kancloud.cn/9c1c1bf48494afdd7545fc9130cfca9a_1791x987.png)
* * * * *
开放平台目前有两种类型支持,自有应用服务模式和开放应用服务模式两种类型的应用。其中个体商户和企业开发者可以创建自有应用服务模式的应用,只能授权自己账户使用,而第三方服务商只能创建开放应用服务模式的应用,可以授权多个商户使用。根据提示填写好表单点击提交信息即可,创建应用也是需要我们1-3个工作日完成审核。可关注[我的申请 --> 我的记录](http://dev.10ss.net/admin/listinfo)(`http://dev.10ss.net/admin/listinfo`)应用列表中查看对应的应用状态提示看到审核信息。
## **第三步:接口开发**
应用app通过审核之后可获取查看[我的申请 --> 我的记录](http://dev.10ss.net/admin/listinfo)(`http://dev.10ss.net/admin/listinfo`)应用列表中点击对应的应用描述查看详情看到 *App应用ID* 和 *App应用密钥* 然后阅读商户授权和API文档列表进行开发使用。
## **第四步:联调测试**
1.商户授权介绍
2.API调用文档
3.内容排版
4.使用SDK开发
5.接收推送消息
其中消息推送目前有三种支持:
1.打印完成状态推送
2.接单拒单推送
3.终端状态推送
在[我的申请 --> 我的记录](http://dev.10ss.net/admin/listinfo)(`http://dev.10ss.net/admin/listinfo`)应用列表中点击对应项目app进行设置。
地址设置要求满足两点需要:
1.请求推送地址填写必须以`http://`或`https://`开头的地址。
2.推送地址需要支持GET访问,当GET请求访问时,请直接返回{"data":"OK"},推送上报地址的可用性测试。
根据使用性设置好推送地址后有开启和关闭按钮,如果推送的内容失败开关会显示感叹号异常提醒。
## **第五步:正式上线**
当开发者完成应用的开发调试后,开发完成后正式上线。
## **第六步:商家接入**
商户可以投放给自己客户进行使用,完成应用正式接入。
- 平台简介
- 概念和术语
- 新手指南
- 开发文档
- 接入API服务指南
- API调用协议说明
- 开放应用服务模式
- 自有应用服务模式
- 扫描二维码授权模式
- 消息推送协议说明
- API文档列表
- 文本打印接口
- 图形打印接口
- 面单打印接口
- 设置内置语音接口
- 删除内置语音接口
- 删除终端授权
- 添加应用菜单
- 关机重启接口
- 声音调节接口
- 获取机型打印宽度接口
- 获取机型软硬件版本接口
- 取消所有未打印订单接口
- 取消单条未打印订单接口
- 设置logo接口
- 取消logo接口
- 打印方式接口
- 接单拒单设置接口
- 设置推送url接口
- 获取订单状态接口
- 获取订单列表接口
- 获取终端状态接口
- 推送接口
- 签名规则
- 打印完成推送
- 接单拒单推送
- 按键请求推送
- 应用菜单推送
- 打印机实时状态推送
- 打印机指令
- K7-GHC/K7-WHC排版指令
- K4-GH(新固件)/K4-WH(新固件)排版指令
- K6-WH(新固件)排版指令
- M1-G(新固件)排版指令
- W1(新固件)排版指令
- K5(新固件)排版指令
- K2S、K3S、M1排版指令
- K7、K6、K5、K4排版指令
- X1排版指令
- W1排版指令
- Ai语音播报指令
- 指令详解
- 二维码打印
- 条码打印
- 打印多联
- 字体加大
- 字体加粗
- 字体加高
- 字体加宽
- 换行
- 居中对齐
- 左右对齐
- 右对齐
- 一行三格或四格对齐排版
- 制表符
- 自定义来单提醒
- 自定义来单声音控制
- 订单确认
- SDK使用说明
- 注意事项
- 全局返回码
- 获取终端号和特殊密钥