api使用
一、获取ticket
服务商后台-应用管理-应用详情-刷新ticket
企业微信每15分钟会自动刷新一次ticket,调用指令回调配置的接口
二、获取第三方应用凭证
作用:调用企业微信(网页授权登录)“获取访问用户身份”时候的入参”
获取预授权码 入参,获取企业永久授权码 入参
调用接口及入参如下:
API:https://qyapi.weixin.qq.com/cgi-bin/service/get_suite_token
入参:
{
"suite_id":"ww4f66fa544a32f920" ,
"suite_secret": "vVv8JzaBlEVCTQkHKqmr57EAMs65AILWiI_4ANc25T4",
"suite_ticket": "Uc8vAAYl6Rvb4-ShZ1i95l4okcan91cxg-eiXlPSX3rU5u7Cpp3O9C1fN5resTWw"
}
出参:
{
"suite_access_token": "Uu3Nplvf50qU7mzFSh4sa5G_8-xSub-4NXsgc-3SUpucWjr_Ov84BJ3BukTCpNxSlX8FscrV7HeteHq_xTSt3nVt6sf_CKNgn8nhysZDtjcazgN21Hgd9Ub1K2ceTsxP",
"expires_in": 7200
}
三、服务商的token
作用:调用企业微信(扫码)“获取访问用户身份”时候的入参
调用接口及入参如下:
API:https://qyapi.weixin.qq.com/cgi-bin/service/get_provider_token
入参:
{
"corpid":"ww14438c6c07a317f2",
"provider_secret":"RH7PehRJX3LIcw4axad_H2T9HSUG1finOBEpnLTVIioBrP-zgZrGsqJ9pHVw5vVj"
}
出参:
{
"provider_access_token": "1GXKi47D10Ruu8kdKv1V1cXbNz3i6WjvsCF135XYv5aIN6oJyZ7TNhAYma60gWFihAlxBPwHBNxzsuGclPZ7QbhlUYr6jzkZ3F81xi6K2MJ-rZ4W_ChNzG9fo0mpwbQR",
"expires_in": 7200
}
四、获取企业永久授权码
作用:获取“授权方(企业)access_token”值
获取企业永久授权码有两种方式:
1、会在授权成功时附加在redirect_uri中跳转回第三方服务商网站,
2、通过授权成功通知回调推送给服务商。
API: https://qyapi.weixin.qq.com/cgi-bin/service/get_permanent_code?suite_access_token=SUITE_ACCESS_TOKEN
SUITE_ACCESS_TOKEN替换成第三方应用凭证,如下
SUITE_ACCESS_TOKEN = Uu3Nplvf50qU7mzFSh4sa5G_8-xSub-4NXsgc-3SUpucWjr_Ov84BJ3BukTCpNxSlX8FscrV7HeteHq_xTSt3nVt6sf_CKNgn8nhysZDtjcazgN21Hgd9Ub1K2ceTsxP
入参:
{
"auth_code": "lEPN8e8WMf9wg0lN-Gc_a18mvwab3WXW-523-bxk7YMXPMTY_Pk4A"
}
出参:
{
"errcode":0,
"errmsg":"ok",
"access_token": "ScVYefHLkgC4pq0w-iBXRlOdLh9pUk4D8lxGT5ed_seCzqlG9PDz6gVGiB552SQlBCXMd7vaKAo_Fpu_obpZ70fgUYrvcvzt8ZG7a7fHJ1qPg-y7wbJjqSugobMSathNYb0_Eni3nB8hPTK8H5_RyBNn05cQ3yOd-AZIwxYbNejguuJ6FcINILu-slmf1ES8CCbtopkGy2lpmwrqUgimQ",
"expires_in": 7200,
"permanent_code": "04RGGCWltNhW_H0KoeT_mdyIKQ52nLqvoU6WV_TCz-c",
"auth_corp_info":
{
"corpid": "wpHXx7EAAAJODtytMO7Xpu7qWNPB-GFw",
"corp_name": "wpHXx7EAAAJODtytMO7Xpu7qWNPB-GFw",
},
"auth_user_info":
{
"userid":"aa",
}
}
五、获取企业凭证
作用:用于“获取用户信息”,“部门信息”,“信息发送”,“应用生成ticker”,“企业生成ticker”接口等入参
API: https://qyapi.weixin.qq.com/cgi-bin/service/get_corp_token?suite_access_token=SUITE_ACCESS_TOKEN
SUITE_ACCESS_TOKEN 替换成第三方应用凭证,如下
SUITE_ACCESS_TOKEN = Uu3Nplvf50qU7mzFSh4sa5G_8-xSub-4NXsgc-3SUpucWjr_Ov84BJ3BukTCpNxSlX8FscrV7HeteHq_xTSt3nVt6sf_CKNgn8nhysZDtjcazgN21Hgd9Ub1K2ceTsxP
入参:
{
"auth_corpid": "wpHXx7EAAAJODtytMO7Xpu7qWNPB-GFw",
"permanent_code": "04RGGCWltNhW_H0KoeT_mdyIKQ52nLqvoU6WV_TCz-c"
}
出参:
{
"access_token": "0nqExjiBxP9XpD1nkWO6AwrUdqvFwNXxNi0lkbu-APYU0TFJkeW6agXPoopqorZyFYTYCf5q3iz0cyWS9sJgsnkpBfZZ94g3gj6d0Bel6C8i6guCnXCS-f0e0CfKea-NIRpH10Jv93T-g6dHMpyX_JVPb2eznMUISBVEbWgFIL6SmnzYSfPVjoz225mDwxOixM3mwMZUiHSt_axCDWIXrA",
"expires_in": 7200
}
六、以上接口可以参考企业微信第三方应用api
https://developer.work.weixin.qq.com/document/path/90600
如下图红色部分
转自:https://www.cnblogs.com/why0703/p/15983925.html