# 开发者服务指引
### 一、OAuth2.0授权流程
1. OAuth 2.0的运行流程如下图,摘自RFC 6749。

### 二、自有型应用-OAuth2.0客户端模式
1. 利用client_id、client_secret通过开放平台提供的[授权接口](自有型应用.md),获取调用凭证(access_token)。
2. 利用调用凭证(access_token),进行后续的[API](API文档.md)对接。
### 三、开放型应用-OAuth2.0授权码模式
1. 利用client_id、client_secret通过开放平台提供的[授权接口](开放型应用.md),获取授权地址。
2. 开发者将授权地址提供给用户通过浏览器访问、登录(也可通过终端号、终端密钥登录)、选择需授权的终端号(machine_code)进行授权,通过应用中设置的回调地址,采用重定向方式传递授权码(code)。
3. 利用授权码(code),通过授权接口换取调用凭证(access_token)、刷新凭证(refresh_token)。
4. 利用调用凭证(access_token),进行后续的[API](API文档.md)对接。
### 四、开放型应用-扫码授权模式
1. 通过技术手段,获取打印机底部信息二维码或菜单中的本机信息中的二维码获得终端号(machine_code)、终端密钥(msign)或者终端临时密钥(qr_key)。
2. 利用machine_code、msign或machine_code、qr_key通过开放平台提供的[授权接口](扫码授权.md),获取调用凭证(access_token)、刷新凭证(refresh_token)。
3. 利用调用凭证(access_token),进行后续的[API](API文档.md)对接。
- 使用前准备【必看】
- 开发者服务指引【必看】
- 接口更新动态
- 2024年5月
- 2024年1月
- 2023年11月
- 2023年10月
- 2023年9月
- 2023年6月
- 开发文档【必看】
- 调用协议【必看】
- 授权文档【必接】
- 自有型应用
- 开放型应用(OAuth2.0授权码模式)
- 开放型应用(扫码授权模式)
- SDK使用说明
- API文档【按需对接】
- 设备文档
- 设备绑定
- 设备解绑或取消授权
- 状态获取
- 离线或重启控制
- 打印控制
- logo控制
- 音效音量控制
- 内置语音控制
- 打印宽度获取
- 型号版本获取
- 接单拒单控制
- 打印文档
- 文本打印
- 图片打印
- 面单文档
- 面单生成并打印
- 面单取消
- 打印队列文档
- 订单状态获取(单订单)
- 订单列表获取
- 订单取消打印(单订单)
- 订单取消打印(全量)
- 订单重打(单订单)
- 应用设置文档
- 推送地址设置
- K8支付设置文档
- 推送开关设置
- 关键词设置
- 高级设置
- 打印消息推送
- 打印消息推送说明
- 打印完成推送
- 终端状态推送
- 接单拒单推送
- K8扫码信息推送
- 扫码相关功能流程图
- 产品介绍
- 授权说明
- 消息推送
- http/https推送方式
- 签名验证规则
- 解密规则
- 指令说明
- 验签解密示例
- 打印指令文档
- 指令文档说明
- 文本打印指令集
- 语音指令文档
- 多语言指令文档
- 扫码功能指令
- 常见问题
- 错误码说明
- FAQ