服务商相关接口
单点登录
获取从第三方单点登录连接
$app->provider->getLoginUrl(string $redirectUri = '', string $userType = 'admin', string $state = ''); //$redirectUri 回调地址 $userType支持登录的类型
获取登录用户信息
$app->provider->getLoginInfo(string $authCode); //$authCode oauth2.0授权企业微信管理员登录产生的code,最长为512字节。只能使用一次,5分钟未被使用自动过期
注册定制化
获取注册码
$app->provider->getRegisterCode(
string $corpName = '', //企业名称
string $adminName = '',//管理员姓名
string $adminMobile = '',//管理员手机号
string $state = ''//自定义的状态值
);
获取注册Uri
$app->provider->getRegisterUri(string $registerCode = ''); //$registerCode 注册码
查询注册状态
$app->provider->getRegisterInfo(string $registerCode); //$registerCode 注册码
设置授权应用可见范围
$app->provider->setAgentScope(
string $accessToken, //查询注册状态接口返回的access_token
string $agentId, // 授权方应用id
array $allowUser = [], //应用可见范围(成员)若未填该字段,则清空可见范围中成员列表
array $allowParty = [], // 应用可见范围(部门)若未填该字段,则清空可见范围中部门列表
array $allowTag = [] //应用可见范围(标签)若未填该字段,则清空可见范围中标签列表
)
设置通讯录同步完成
$app->provider->contactSyncSuccess(string $accessToken); //$accessToken //查询注册状态接口返回的access_token
通讯录单个搜索
$app->provider->searchContact(
string $corpId, //查询的企业corpid
string $queryWord, //搜索关键词。当查询用户时应为用户名称、名称拼音或者英文名;当查询部门时应为部门名称或者部门名称拼音
string $agentId, //授权方应用id
int $offset = 0, //查询的偏移量,每次调用的offset在上一次offset基础上加上limit
int $limit = 50, //查询返回的最大数量,默认为50,最多为200,查询返回的数量可能小于limit指定的值
int $queryType = 0, //查询类型 1:查询用户,返回用户userid列表 2:查询部门,返回部门id列表。 不填该字段或者填0代表同时查询部门跟用户
$fullMatchField = null //如果需要精确匹配用户名称或者部门名称或者英文名,不填则默认为模糊匹配;1:匹配用户名称或者部门名称 2:匹配用户英文名
)