微信邦 发表于 2014-6-30 09:45:13

微信授权关系接口调用指引

通过code获取access_token接口说明通过code获取access_token的接口。
请求说明http请求方式: GEThttps://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
参数说明
参数是否必须说明
appid是应用唯一标识,在微信开放平台提交应用审核通过后获得
secret是应用密钥AppSecret,在微信开放平台提交应用审核通过后获得
code是填写第一步获取的code参数
grant_type是填authorization_code

返回说明正确的返回:{
"access_token":"ACCESS_TOKEN",
"expires_in":7200,
"refresh_token":"REFRESH_TOKEN",
"openid":"OPENID",
"scope":"SCOPE"
}

参数说明
access_token接口调用凭证
expires_inaccess_token接口调用凭证超时时间,单位(秒)
refresh_token用户刷新access_token
openid授权用户唯一标识
scope用户授权的作用域,使用逗号(,)分隔

错误返回样例:{
"errcode":40029,"errmsg":"invalid code"
}
刷新或续期access_token使用接口说明access_token是调用授权关系接口的调用凭证,由于access_token有效期(目前为2个小时)较短,当access_token超时后,可以使用refresh_token进行刷新,access_token刷新结果有两种:
[*]1. 若access_token已超时,那么进行refresh_token会获取一个新的access_token,新的超时时间;
[*]2.若access_token未超时,那么进行refresh_token不会改变access_token,但超时时间会刷新,相当于续期access_token。
refresh_token拥有较长的有效期(30天),当refresh_token失效的后,需要用户重新授权。
请求方法使用/sns/oauth2/access_token接口获取到的refresh_token进行以下接口调用:http请求方式: GEThttps://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN
参数说明
参数是否必须说明
appid是应用唯一标识
grant_type是填refresh_token
refresh_token是填写通过access_token获取到的refresh_token参数

返回说明正确的返回:{
"access_token":"ACCESS_TOKEN",
"expires_in":7200,
"refresh_token":"REFRESH_TOKEN",
"openid":"OPENID",
"scope":"SCOPE"
}

参数说明
access_token接口调用凭证
expires_inaccess_token接口调用凭证超时时间,单位(秒)
refresh_token用户刷新access_token
openid授权用户唯一标识
scope用户授权的作用域,使用逗号(,)分隔

错误返回样例:{
"errcode":40030,"errmsg":"invalid refresh_token"
}
接口说明检验授权凭证(access_token)是否有效请求说明http请求方式: GEThttps://api.weixin.qq.com/sns/auth?access_token=ACCESS_TOKEN&openid=OPENID
参数说明
参数是否必须说明
access_token是调用接口凭证
openid是普通用户标识,对该公众号唯一

返回说明正确的Json返回结果:{
"errcode":0,"errmsg":"ok"
}
错误的Json返回示例:{
"errcode":40003,"errmsg":"invalid openid"
}
获取用户个人信息(UnionID机制)接口说明此接口用于获取用户个人信息。开发者可通过OpenID来获取用户基本信息。特别需要注意的是,如果开发者拥有多个移动应用、网站应用和公众号,可通过获取用户基本信息中的unionid来区分用户的唯一性,因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众号,用户的unionid是唯一的。换句话说,同一用户,对同一个微信开放平台下的不同应用,unionid是相同的。请求说明http请求方式: GEThttps://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID
参数说明
参数是否必须说明
access_token是调用凭证
openid是普通用户的标识,对当前开发者账号唯一,获取该openid的好友列表

返回说明正确的Json返回结果:{
"openid":"OPENID",
"nickname":"NICKNAME",
"sex":1,
"province":"PROVINCE",
"city":"CITY",
"country":"COUNTRY",
"privilege":[
"PRIVILEGE1",
"PRIVILEGE2"
],
"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"

}

参数说明
openid普通用户的标识,对当前开发者账号唯一
nickname普通用户昵称
sex普通用户性别,1为男性,2为女性
province普通用户个人资料填写的省份
city普通用户个人资料填写的城市
country国家,如中国为CN
privilege用户特权信息,json数组,如微信沃卡用户为(chinaunicom)
unionid用户统一标识。针对一个微信开放平台帐号下的应用,同一用户的unionid是唯一的。

错误的Json返回示例:{
"errcode":40003,"errmsg":"invalid openid"
}
调用频率限制
接口名频率限制
通过code换取access_token1万/分钟
刷新access_token5万/分钟
获取用户基本信息5万/分钟

推荐阅读:
深度解析:UnionID和微信登陆如何让微信做到连接一切!
http://www.wxuse.com/thread-13505-1-1.html
微信授权关系接口调用指引
http://www.wxuse.com/thread-13408-1-1.html
移动应用微信登录开发指南
http://www.wxuse.com/thread-13407-1-1.html
页: [1]
查看完整版本: 微信授权关系接口调用指引