获取二次认证信息

设备连接卡板 WiFi 后，可通过本接口获取运营商二次认证所需的 token 或凭据。接口不使用 OpenAPI 的 access_key、签名、时间戳和 nonce。

普通移动 token 请使用 POST /api/v1/token；详见获取移动 Token。它与本接口的二次认证信息相互独立。

接口信息

key 必传，iccid 可选：

• 仅传 key：按渠道返回统一二次认证信息；移动返回二次认证 token，电信返回认证凭据。
• 同时传入：按卡板返回认证信息，并校验渠道密钥是否属于该卡板渠道。

移动卡按卡板查询时，返回规则如下：

• 上游返回 token：使用 appid + token 的统一二次认证方式，不返回卡级密钥。
• 上游未返回 token：改为返回 deviceAuthAppid + deviceAuthPassword 卡级认证凭据。

key（渠道密钥）是敏感信息，不要写入客户端日志、前端代码或公开仓库。

请求参数

请求示例

按渠道获取：

curl -G 'https://your-domain.com/api/v1/secondary-auth' \
  --data-urlencode 'key=渠道的channel_key'

按卡板获取：

curl -G 'https://your-domain.com/api/v1/secondary-auth' \
  --data-urlencode 'iccid=898600xxxxxxxxxxxx' \
  --data-urlencode 'key=渠道的channel_key'

返回字段

成功响应示例

移动统一二次认证：

{'{'}
  "code": 0,
  "status": true,
  "msg": "success",
  "data": {'{'}
    "appid": "C50107xx",
    "token": "978f5c0d4d8b4b...",
    "required": true,
    "operator": "CMCC",
    "ttl": 3600
  {'}'}
{'}'}

移动卡级二次认证（上游未返回 token）：

{'{'}
  "code": 0,
  "status": true,
  "msg": "success",
  "data": {'{'}
    "deviceAuthAppid": "CARD_APPID",
    "deviceAuthPassword": "CARD_PASSWORD",
    "required": true,
    "operator": "CMCC",
    "ttl": 0
  {'}'}
{'}'}

电信认证：

{'{'}
  "code": 0,
  "status": true,
  "msg": "success",
  "data": {'{'}
    "appkey": "APP_KEY",
    "appsecret": "Secret_Key",
    "required": true,
    "operator": "CTCC",
    "ttl": 0
  {'}'}
{'}'}

失败响应

{'{'}
  "code": 1,
  "status": false,
  "msg": "key不能为空"
{'}'}

常见失败信息：