# 新手指南
[TOC=2,3]
## **第一步:入駐成為開發者**
首先填寫申請表單成為開放平臺開發者,點擊 [申請加入](http://dev.10ss.net/join#join) (`http://dev.10ss.net/join#join`) 填寫對應的信息。如果*未登錄*,請登錄賬號后方可申請加入,請直接使用易聯云賬號登錄開放平臺,完成開發者入駐。
* * * * *
*如下是申請樣圖(個人申請):*

* * * * *
申請中主要分為兩種開發者類型:
1.個人開發者
2.企業商戶開發團體
* * * * *
*如下是申請樣圖(企業商戶):*

* * * * *
提交入駐申請之后,我們會在1-3個工作日完成開發者身份審核。如果您是第三方服務商,想為商戶提供軟件服務,請在開放平臺注冊賬號,完成第三方服務商開發者入駐。
## **第二步:創建應用**
申請入駐成功后就可以進入開放平臺開始使用了,入口點擊[開始使用開放平臺](http://dev.10ss.net/admin)(`http://dev.10ss.net/admin`)。
查看我的申請 --> 查看詳情 --> 添加App應用
* * * * *
如圖進入app申請表單:

* * * * *
開放平臺目前有兩種類型支持,自有應用服務模式和開放應用服務模式兩種類型的應用。其中個體商戶和企業開發者可以創建自有應用服務模式的應用,只能授權自己賬戶使用,而第三方服務商只能創建開放應用服務模式的應用,可以授權多個商戶使用。根據提示填寫好表單點擊提交信息即可,創建應用也是需要我們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使用說明
- 注意事項
- 全局返回碼
- 獲取終端號和特殊密鑰