会员


会员中心
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
查询field为value的search字段值。如需查询已登录用户自己的所有信息,可不传任何参数(search默认为my)。如需根据guid查询username:search填'username',field填'guid',value填'用户名'
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
search string 查询结果:默认为my,即已登录用户的所有信息,支持all(任意用户所有信息)/username/email/mobile/avatar/loginip/jointime等
field string 查询条件字段:默认guid,支持guid/username/mobile/email/id
value string 查询条件判断值,与field组合进行条件判断查询
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
生成用户密码
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
user_guid string 用户guid
password string 密码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
第三方账号解绑
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
openid string 用户openid
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
用户不存在则新建
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
openid string 用户openid
mobile string 手机号
captcha string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
第三方账号绑定用户中心
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
openid string 用户openid
account string 用户名/邮箱/手机
password string 密码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
openid用户不存在则新建,用户存在但手机不同则换绑
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
code string 手机号快速验证Code码
openid string 用户openid
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
第三方获取用户手机
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
code string 手机号快速验证Code码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
第三方获取用户授权信息
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
openid string 用户openid
detail string 微信参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
第三方登录
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
code string Code码
pid string 上级用户UID,默认为0
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
查询登录用户的行为日志
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
type string 行为类型,不传默认返回全部(login_success:登录成功)
staff_id string 员工ID
limit integer 每页数量,默认10
page integer 页码,默认1
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
查询登录用户权限
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
会员登录
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
account string 账号
password string 密码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
设置或修改密码
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
oldpassword string 旧密码,手机注册新用户不传
newpassword string 新密码
renewpassword string 重复新密码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
用户是否设置过密码
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
account string 账号(可使用账号,用户名,邮箱,手机号)
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
重置密码
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号
email string 邮箱
type string 类型:mobile|email
newpassword string 新密码
captcha string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
修改手机号
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
mobile string 手机号
captcha string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
修改邮箱
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
email string 邮箱
captcha string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
修改会员个人信息
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
avatar string 头像地址,先调用common/upload接口上传图片
username string 用户名
nickname string 昵称
bio string 个人简介
gender string 性别:0未知,1男,2女
birthday string 生日:格式1999-09-09
realname string 用户实名
license_type string 身份证件类型(1居民身份证2港澳通行证3台湾通行证4护照)
license_no string 身份证件号码
bank_name string 开户行
bank_account string 银行卡号
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
注销登录
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
注册会员
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
username string 用户名
password string 密码
email string 邮箱
mobile string 手机号
code string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
手机验证码登录
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)app_guid当前应用guid,corporation_guid当前登录的企业guid(不传则获取默认登录企业)
参数
名称 类型 必选 描述 示例
mobile string 手机号
captcha string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
向指定用户发送点对点消息
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
uid string 接收消息的用户uid
msg string 消息内容
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

Token


检测Token是否过期
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
原Token失效,替换为新Token再进行后续操作
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

验证


检测邮箱
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
email string 邮箱
id string 排除会员ID
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测用户名
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
username string 用户名
id string 排除会员ID
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测手机号是否占用
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号
id string 排除会员ID
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测手机号是否存在
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测邮箱
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 邮箱
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测手机验证码
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号
captcha string 验证码
event string 事件
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测邮箱验证码
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
email string 邮箱
captcha string 验证码
event string 事件
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

手机短信


同一个签名,对同一个手机号的发送频率:1分钟内短信发送条数不超过1条,1小时内短信发送条数不超过5条,1个自然日内短信发送条数不超过10条
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号
event string 事件名称:register注册/mobilelogin手机登录(自动注册)/changemobile修改手机/resetpwd修改密码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测验证码
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号
event string 事件名称
captcha string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
发送通知短信
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号,多个用英文逗号隔开,上限1000个
event string 事件名称:aprv_start审批提醒/aprv_end审批通过/aprv_reject审批驳回/changeemail修改邮箱/resetpwd修改密码
content object 模板内容
{'name':'wangwu','height':'180'}
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
企业信使短信发送
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
mobile string 手机号
content string 短信内容
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

邮箱验证码


发送验证码
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
email string 邮箱
event string 事件名称:register注册/changeemail更改邮箱/resetpwd用邮箱重置密码/changepwd
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
检测验证码
Headers
名称 类型 必选 描述
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
email string 邮箱
event string 事件名称
captcha string 验证码
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

微服务-平台高级管理


显示平台列表
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
limit integer 每页数量,默认10
page integer 页码,默认1
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
新增平台
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
name string 平台名称
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
显示指定的平台
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
id string 平台guid
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
注意:仅传需更新的字段
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
name string 平台名称
江苏省农科院
id string 平台guid
xxxxx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
删除指定平台
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
id string 平台guid
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
显示应用列表
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
显示应用帮助手册
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
更新应用帮助手册
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
app_guid string 应用guid
xxxxx
content object 帮助手册内容,json格式,图片通过公共接口上传获取地址
[{'id':1,'title':'帮助1','answer':'如何如何','pics':['http://1','http://2']},{'id':2,'title':'帮助2','answer':'如何如何','pics':['http://1','http://2']}]
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
新增应用
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
platform_guid string 应用所属平台guid
86c5ed47106c9003
app_type string 应用类型,web(网站)或third_app(第三方应用)
third_app
title string 应用标题
鸿景物联溯源(发布版)
desc string 应用描述
鸿景物联溯源(发布版)
url string 网站域名,应用类型为web必填
http://www.xxx.com
third_id integer 第三方应用类型id,应用类型为third_app必填,1微信网站应用、2微信公众号、3微信小程序、4微信open开发平台APP
3
account string 第三方应用登录账户,应用类型为third_app必填
abc@126.com
appid string 第三方应用appid,应用类型为third_app必填
wxabcdefghijklmn
appsecret string 第三方应用appsecret,应用类型为third_app必填
e569b32833968a1231231231239041
gh_id string 第三方应用原始id,应用类型为third_app,且third_id为2或3必填
gh_5aa4f7bb6127
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
新增企业隐藏超管
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
平台超管可管理平台内应用、企业、用户,可接管企业
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
platform_guid string 平台guid
86c5ed47106c9003
user_id integer 用户id
1111
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
平台超管可清空所有用户token
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
platform_guid string 平台guid
86c5ed47106c9003
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
平台超管可清空指定用户token
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;),其中app_guid必须是中心超管应用
参数
名称 类型 必选 描述 示例
platform_guid string 平台guid
86c5ed47106c9003
user_id integer 用户id
1111
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

微服务-平台基础管理


显示平台面板数据
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
接管企业
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=xxxxxx;)
参数
名称 类型 必选 描述 示例
corporation_guid string 要接管的企业guid
xxxxxx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
注意:仅传需更新的字段。自动同步企业信息
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
pack_type integer 套餐类型
1
pack_valid_time string 套餐到期时间,不传则默认永久有效
2022-10-1
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

微服务-企业权限管理


显示中心全部权限节点
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
显示企业套餐权限信息
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
显示企业职能角色列表
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
新增企业职能角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
auth_name string 职能角色名称
生化部危险品实验人员
node_ids string 权限节点id,逗号分隔,需同时传选中子节点的所有父节点id
97,98,99,100,101,14,13
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
更新企业职能角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
auth_group_id integer 职能角色id
1
node_ids string 权限节点id,逗号分隔,需同时传选中子节点的所有父节点id
97,98,99,100,101,14,13
auth_name string 职能角色名称
生化部危险品实验人员
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
删除企业职能角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
auth_group_id integer 职能角色id
1
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
更新企业员工职能角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
staff_guid string 员工guid
xxxxxx
group_ids string 职能角色id,从属多个以逗号分隔
1,2
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
显示企业岗位角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
新增企业岗位角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
career_title string 岗位名称
经理
level integer 岗位级别,不传则默认1
8
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
更新企业岗位角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxxx
career_id integer 岗位角色id
1
career_title string 企业专属岗位名称
经理
level integer 岗位级别
1
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
删除企业岗位角色
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
career_id integer 岗位角色id
1
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数

微服务-企业基础管理


显示企业列表
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
limit integer 每页数量,默认10
page integer 页码,默认1
my_registered integer 是否只显示登录用户注册的企业(1是0否),默认0显示全部
search string 根据企业名模糊搜索
search_status integer 申请状态(0审核通过和待审核|1审核通过|2待审核|3审核拒绝|4全部)默认0
organization_attribute integer 企业属性/单位类型,支持英文逗号分隔多个属性,如14,15
levelcode integer 省市区级别,如1,2,3,默认0显示全部
only_sub integer 是否仅显示下级企业(1是0否),默认0显示全部
start_time string 注册时间,格式2020-01-01(查询开始)
end_time string 注册时间,格式2020-01-01(查询结束)
forward_organization_guid string 注册渠道guid,格式abcdefg
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
删除指定企业
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
id string 企业guid
staff_guid string 员工guid
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
查询技术机构列表
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
查询企业简单信息列表
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
organization_attribute integer 企业属性/单位类型,支持英文逗号分隔多个属性,如14,15
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
批量导入企业
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
file_path string 文件路径(上传文件/api/common/upload接口返回的url),格式xlsx
/uploads/xxx.xlsx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
批量导入企业预览
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
file_path string 文件路径(上传文件/api/common/upload接口返回的url),格式xlsx
/uploads/xxx.xlsx
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
批量导入模板下载
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
批量新增企业
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
企业新增单个用户和员工
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
corporation_guid string 企业guid
xxxxx
staff_name string 员工姓名
王思聪
mobile string 员工手机号
18688888888
tel string 员工办公电话
025-8888888
address string 员工地址
南京xxxxx
area_id string 员工区域id,显示中国省市县列表/api/common/area_list获得,精确到区级,鼓楼区825
825
staff_no string 员工工号
5
industry_id string 员工行业id
1
group_ids string 员工职能角色id,从属多个以逗号分隔
1,2
signature string 员工数字签名
http://url
desc string 员工备注
新入职1个月
status integer 员工状态(0待审核 1在职 2离职 3停薪留职 4退休 5返聘)
1
birthday string 用户生日
2021-08-31
gender integer 用户性别(0未知 1男 2女)
1
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
显示指定企业的审核意见
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
id string 企业guid
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
新增成功自动同步企业信息
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
pid string 上级企业guid
xxxxxx
name string 企业名称
abc公司
username string 企业用户名,用于分配账号
abc
desc string 企业描述
legal_person_name string 企业法人
王思聪
address string 地址
南京xxxxx
license string 统一社会信用代码
91320102MA1Q2EQK0R
license_pic string 营业执照图片
https://oss.pic.com/1.jpg
business_term string 营业期限(格式:2017/01/01-2025/01/01)
2017/01/01-2025/01/01
is_long string 是否长期(0否 1是)
organization_code string 组织机构代码
MA1Q2EQK-0
area_code string 行政编码
110100000000
precinct string 管辖区编码集合,用于行政部门或其他部门管理的辖区,多个编码用|分隔
320000|320001
area_id string 区域id,显示中国省市县列表/api/common/area_list获得,精确到区级,鼓楼区825
825
zipcode string 邮政编码
210000
industry_id string 行业id
1
geoxy string 企业地理位置坐标经纬度,英文逗号隔开
118.803742,32.046851
levelcode string 机构级别(省级1,市级2,区县级3),默认0
1
organization_attribute string 企业属性(1股份有限公司 2有限责任公司 3国有企业 4集体所有制 5私营企业 6有限合伙企业 7联营企业 8外商投资企业 9个人独资企业 10非盈利机构 11政府部门 12一般性工作机构 13社会团体 14GAP技术机构 15GAP工作机构)
14
contact object 联系人信息(集合)
[{'contact_person':'姓名(必填)','contact_person_pos':'职务','contact_person_id_card':'身份证号','contact_mobile':'手机号','contact_fax':'传真','contact_email':'电子邮件','contact_tel':'座机号码','contact_qq':'QQ号码'},{'contact_person':'小王','contact_person_pos':'总经理','contact_person_id_card':'21080819900101000X','contact_mobile':'18888888888','contact_fax':'025-66666666','contact_email':'example@qq.com','contact_tel':'025-88888888','contact_qq':'88888888'}]
channel object 注册渠道(集合),key为自定义渠道名,value为渠道标识,支持key:forward_organization_guid
{'forward_organization_guid':'abcdefg'}
正文
Headers
参数 / 正文
响应输出

                                                            

                                                        
返回参数
审核企业
Headers
名称 类型 必选 描述
token string 请求的Token
Authorization string 请求的Authorization(例:app_guid=40d5e7c7b22de844; corporation_guid=53b5e5d4466712c7;)
参数
名称 类型 必选 描述 示例
id string 企业guid
xxxxxx
action string 审核操作(accept审核通过/reject审核拒绝)
accept
staff_guid string 员工guid
xxxxxx
comment string 审核意见
同意
signature string 数字签名
https://url
attachment string 附件
https://url
正文