获取设备型号调用凭证

POST

https://qyapi.weixin.qq.com/cgi-bin/openhw/get_model_token

该API用于获取设备型号调用接口的凭证（model_access_token）。

获取model_access_token时，需要model_ticket参数。model_ticket由企业微信后台定时推送给“指令回调URL”，每十分钟更新一次.
model_ticket实际有效期为30分钟，可以容错连续两次获取model_ticket失败的情况，但是请永远使用最新接收到的model_ticket。
通过本接口获取的model_access_token有效期为2小时，开发者需要进行缓存，不可频繁获取。

注意：因历史原因，该接口在调用失败时才返回errcode。没返回errcode视为调用成功

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/openhw/get_model_token' \
--header 'Content-Type: application/json' \
--data-raw '{
	"model_id":"mdddddccc7775555aaa" ,
	"model_secret": "ldAE_H9anCRN21GKXVfdAAAAAAAAAAAAAAAAAA", 
	"model_ticket": "Cfp0_givEagXcYJIztF6sfbdmIZCmpaR8ZBsvJEFFNBrWmnD5-CGYJ3_NhYexMyw" 
}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "model_access_token": "61W3mEpU66027wgNZ_MhGHNQDHnFATkDa9-2llMBjUwxRSNPbVsMmyD-yq8wZETSoE5NQgecigDrSHkPtIYA",
  "expires_in": 7200
}

请求参数

Body 参数application/json

model_id

string

必需

设备型号ID，在服务商管理端创建设备型号之后，可在页面获取该参数

model_secret

string

必需

设备型号secret，每个型号有一个唯一的secret

model_ticket

string

必需

企业微信后台推送的ticket

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

model_access_token

string

必需

设备型号access_token,最长为512字节

expires_in

integer

有效期（秒）

必需

修改于 2022-12-08 04:00:45