公共服务是为开发者提供了通用的平台基础服务。
主要提供省市区、企业主营行业、企业经营范围等标准化基础服务。对于企业信息中的部分字段,如:省市区、主营行业、企业类型、企业规模等字段,建议通过API进行查询,保证用户企业注册或企业信息修改的顺利进行。
公共服务接口
接口名称:企业一级行业列表查询
请求示例:https://uc.ms.casicloud.com/1/common/industry1?client_id=&ts=&sign=
返回成功示例:
{
"code": 200,
"data" : [
"农、林、牧、渔业",
"采矿业",
"制造业",
"电力、热力、燃气及水生产和供应业",
"建筑业"
] ,
"msg": ""
}
接口名称:企业二级行业列表查询
请求示例:https://uc.ms.casicloud.com/1/common/industry2?client_id=&ts=&sign=&parent_name=
请求参数说明
参数名 |
是否必须 |
类型 |
参数描述 |
parent_name |
否 |
long |
企业一级行业名称,例如:"采矿业" |
返回成功示例:
{
"code": 200,
"data" : [
"煤炭开采和洗选业",
"石油和天然气开采业",
"黑色金属矿采选业",
"有色金属矿采选业",
"非金属矿采选业",
"开采辅助活动",
"其他采矿业"
] ,
"msg": ""
}
Token管理
开放API中的Token接口,为开发者提供了Token信息获取以及Token刷新功能。开发者可以使用Token接口管理用户的登录状态
接口名称:Token信息获取
请求示例:https://auth.ms.casicloud.com/1/token/info?client_id=&ts=&sign=&access_token=
请求参数说明
参数名 |
是否必须 |
类型 |
参数描述 |
access_token |
是 |
string |
登录后分配的access_token |
返回参数说明
参数名 |
类型 |
参数描述 |
access_token |
string |
分配的access token |
expires_in |
long |
access token的有效期,单位为秒 |
refresh_token |
string |
分配的refresh token |
scope |
string |
授权作用域 |
client_id |
string |
分配的clientId |
user_id |
long |
用户ID,选择性给出 |
user_open_id |
string |
用户openId,选择性给出 |
返回成功示例:
{
"code" : 200,
"data" : {
"access_token" : "access_token",
"expires_in" : 28800,
"refresh_token" : "refresh_token",
"scope" : "base",
"user_open_id":"user_open_id",
"client_id" : "client_id"
},
"msg" : ""
}
接口名称:Token刷新
请求示例:https://auth.ms.casicloud.com/1/token/refresh?client_id=&ts=&sign=&refresh_token=&grant_type=
请求参数说明
参数名 |
是否必须 |
类型 |
参数描述 |
refresh_token |
是 |
string |
登录后分配的refresh_token |
grant_type |
是 |
string |
值为refresh_token |
返回参数说明
参数名 |
类型 |
参数描述 |
access_token |
string |
分配的access token |
expires_in |
long |
access token的有效期,单位为秒 |
refresh_token |
string |
分配的refresh token |
scope |
string |
授权作用域 |
client_id |
string |
分配的clientId |
user_id |
long |
用户ID,选择性给出 |
user_open_id |
string |
用户openId,选择性给出 |
返回成功示例:
{
"code" : 200,
"data" : {
"access_token" : "access_token",
"expires_in" : 28800,
"refresh_token" : "refresh_token",
"scope" : "base",
"user_open_id":"user_open_id",
"client_id" : "client_id"
},
"msg" : ""
}