根据手机号码获取认证公司列表
1.功能说明
此接口用于获取认证公司列表,能够得到公司相关信息。
2.接口说明
2.1.接口定义
path |
请求方式 |
接口描述 |
调用权限 |
/platformservice/approvalsBaseInfo/getUserCompanyInfoByMobile |
POST |
根据手机号码获取认证公司列表 |
通用权限 |
2.2.请求头说明
名称 |
是否必须 |
类型 |
默认值 |
备注 |
Authorization |
true |
string |
N/A |
添加服务商级别access_token,如:Bearer b87b77ba-5d5a-4156-8664-f9dacd5baf01 |
Content-Type |
true |
string |
application/json |
application/json |
2.3.请求参数说明
名称 |
是否必须 |
默认值 |
类型 |
备注 |
mobile |
true |
string |
15770735296 |
用户手机号码 |
2.4.返回参数说明
名称 |
是否必须 |
类型 |
备注 |
ret |
true |
string |
请求是否正常返回状态码:"-1"请求异常 ,"0":请求成功 |
errorCode |
true |
string |
请求成功返回null,失败返回code码 |
msg |
true |
string |
成功返回"ok",失败返回错误信息 |
data |
false |
object |
成功返回数据主体,失败不返回 |
companyId |
依赖data字段 |
string |
此公司于云城认证的唯一id |
phone |
依赖data字段 |
string |
手机号码 |
companyName |
依赖data字段 |
string |
公司名称 |
state |
依赖data字段 |
string |
认证状态(wait_review等待审批,cancel_review取消认证,fail_review拒绝,end_review已审批,out_company退出公司) |
userName |
依赖data字段 |
string |
用户姓名 |
email |
依赖data字段 |
string |
用户邮箱 |
isActivate |
依赖data字段 |
string |
是否是激活状态(0激活,1未激活) |
3.请求示例
{ "Authorization": "Bearer 0fad7080-7655-4c42-a766-a200d1ea131a" }
{ "Content-Type": "application/json" }
{"mobile":"15770735296"}
3.1.成功返回示例
{
"ret": "0",
"errorCode": null,
"msg": "ok",
"data": [
{
"companyId": "50541405",
"phone": "15770735296",
"companyName": "万科企业股份有限公司",
"state": "end_review",
"userName": "李芳金",
"email": "",
"isActivate": "0"
}
]
}
3.2.失败返回示例
{
"ret": "-1",
"errorCode": "11002",
"msg": "参数为空",
"data": null
}