有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

1. 接口描述

接口请求域名:iot.cloud.tencent.com/api/exploreropen/appapi。 本接口(AppGetTokenByWeiXin)用于微信用户注册登录,获取开发平台的用户访问 Token,首次调用时,自动为该微信号注册对应账号。

2. 输入参数

名称
类型
必选
描述
Action
String
公共参数,本接口取值:AppGetTokenByWeiXin。
RequestId
String
公共参数,唯一请求 ID,可自行生成,推荐使用 uuid。定位问题时,需提供该次请求的 RequestId。
AppKey
String
公共参数,应用 AppKey ,用于标识对应的小程序或 App。
Signature
String
公共参数,请求签名,需用户自行生成,用于校验请求的合法性。
Timestamp
Int64
公共参数,请求的 UNIX 时间戳(秒级)。
Nonce
Int
公共参数,随机正整数,与 Timestamp 联合起来,防止重放攻击。
WxOpenID
String
微信用户的 OpenID 或 UnionID。
NickName
String
昵称。
Avatar
String
头像。

3. 输出参数

名称
类型
描述
RequestId
String
公共参数,唯一请求 ID,与入参相同。
ExpireAt
Int64
截止时间,UINX 秒级时间戳。
Token
String
开发平台返回的 AccessToken,通过该 Token 进行登录后的接口请求。

4. 示例

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/appapi HTTP/1.1
content-type: application/json
{
"WxOpenID": "0123456789",
"NickName": "tests",
"Avatar": "http://example.com/path/to/avatar.jpg",
"Signature": "IY0yHX7zWCZKZ97xDonQoy16W4U=",
"Timestamp": 1552621825,
"Nonce": 2,
"Action": "AppGetTokenByWeiXin",
"AppKey": "ahPxdK*****TGrejd",
"RequestId": "rest-client"
}
输出示例:成功
{
"Response": {
"Data": {
"ExpireAt": 1556076201,
"Token": "d2******************8514"
},
"RequestId": "rest-client"
}
}
输出示例:失败
{
"Response": {
"Error": {
"Code": "InvalidParameterValue.ErrorUserNotExists",
"Message": "账号不存在"
},
"RequestId": "rest-client"
}
}

5. 错误码

错误码
描述
InternalError
内部错误。
ErrorRequiredParamNotFound
必选参数缺失。
InvalidAction
Action 非法。
InvalidParameterValue
参数异常。
InvalidParameterValue.InvalidJSON
请求格式不是 JSON。
InvalidParameterValue.NickNameLengthInvalid
昵称长度非法