河道采砂监管信息系统共享接口规范、运砂船只自动计量方案.docxVIP

（规范性）

共享接口规范

登录

接口说明：

账号密码登录

接口形式：

URL：https://SERVER:PORT/Share/UserLogin

HTTP方法：POST

输入参数见表A.1。

登录接口输入参数

参数名

是否必填

说明

username

是

账号

password

是

密码

entryType

是

入口类型:1-账号密码登录

输入参数JSON格式

{

username:root,

password:123456,

entryType:1,

}

输出参数见表A.2。

输出参数

字段名

说明

ret

状态码:200-成功，其他-失败

msg

返回信息

data

返回数据

access_token

认证token

expire_at

token到期时间戳

输出参数JSON格式

{

ret:200,

data:{

access_token:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJjZmRjNDUwMyIsImF1ZCI6InVzZXIiLCJzdWIiOiJsM2hPb2lYeTY0dDciLCJ1aWQiOjYsImlhdCI6MTc1NzU1MjY1NywiZXhwIjoxNzU4MTU3NDU3fQ.OY3TP0HVy6QsBLm4LVShIV1K-_6fhcHGQWiFBpwTs7w,

expire_at:1758157457

},

msg:

}

许可采区基础信息及范围共享

许可采区列表

功能说明：

获取该系统下所有许可采区的基础信息包含许可编号省市县代码，可根据地区编码进行查询

接口形式：

URL：https://SERVER:PORT/Share/GetSysLicsAll

HTTP方法：POST

输入参数见表A.3。

输入参数

参数名

是否必填

说明

access_token

是

系统认证token

adcode

否

省市县地区搜索条件如：[410000,410800,410883]或[410000]

certName

否

许可采区名称模糊搜索

输入参数JSON格式

{

access_token:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******,

adcode:[410000],

certName:采区

}

输出参数见表A.4。

输出参数

字段名

说明

ret

状态码:200-成功，其他-失败

msg

返回信息

data

返回数据

province

省

provinceCode

省地区代码

city

市

cityCode

市地区代码

district

区/县

districtCode

区/县代码

certNum

许可证编号

certName

许可采区名称

输出参数JSON格式

{

ret:200,

data:[

{

province:**省,

provinceCode:410000,

city:**市,

cityCode:410800,

district:**市,

districtCode:410883,

certNum:*****-0003,

certName:****采砂区,

},

{

province:**省,

provinceCode:410000,

city:**市,

cityCode:410800,

district:**,

districtCode:410825,

certNum:*****-0001,

certName:**采砂区,

}

],

msg:

}

许可采区基础信息及可采区范围

功能说明：

通过许可证编号获取对应许可采区的详细信息

接口形式：

URL：https://SERVER:PORT/Share/GetLicsInfoByCertNum

HTTP方法：POST

输入参数见表A.5。

输入参数

参数名

是否必填

说明

access_token

是

系统认证token

certNum

是

许可证编号

输入参数JSON格式

{

access_token:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9*******,

certNum:*****-0021

}

输出参数见表A.6。

输出参数

字段名

说明

ret

状态码:200-成功，其他-失败

msg

返回信息

data

返回数据

id

许可证主键ID

province

省

provinceCode

省编码

city

市

cityCode

市编码

district

区/县

districtCode

区/县编码

licence

许可文件编号

certNum

许可证编号

certName

砂场名称