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
如下圖紅色部分