# 认证 API 总览

> 接入 iKho Embedded 需要两级令牌:应用级的合作方令牌用于签发用户令牌,用户级的用户令牌用于绑定设备与上传文件。

开发者平台处于内测阶段,接口契约以联调时提供的正式文档为准;账号由对接工程师开通,见联系我们。

## 两级令牌

合作方令牌代表你的应用,用来为每一位终端用户签发用户令牌;用户令牌代表单个用户,交给 Embedded SDK 与文件上传接口使用。两级令牌各有有效期与鉴权方式。

  | 令牌 | 级别 | 有效期 | 鉴权方式 | 用途 

  | 合作方令牌 partner token | 应用级 | 约 2 小时 | Basic base64(client_id:secret) | 签发用户令牌;通过 refresh_token 刷新自身 
| 用户令牌 user token | 用户级 | 约 24 小时 | Bearer 合作方令牌换取 | 绑定 S1 录音卡、上传音频文件 

## 获取流程

  
    1

    换取合作方令牌
用对接工程师提供的 client_id 与 secret,通过 Basic 鉴权调用 POST /oauth/partner/access-token。

  

  
    2

    为用户签发用户令牌
用合作方令牌作为 Bearer 凭据,为你系统里的每位用户调用 POST /open/partner/users/access-token。

  

  
    3

    到期前刷新
合作方令牌到期前,用签发时返回的 refresh_token 调用 POST /oauth/partner/refresh-token 续期。