3.1 公司信息查询(改)接口设计参考 (api设计)
时间:2023-04-20 20:37:00
3.1 查询公司信息
(1)解释
前端返回user_id,在sys_user如果在表中查询man_buyer_id 为空,目前没有新的公司,进入新的页面。如有,则显示公司的基本信息。
(2)api
数据库
数据表 | 字段 | 外键 | 备注 |
---|---|---|---|
sys_user | man_buyer_id | 通过前端返回userid查询 | |
man_manufacturer | MAN_ID | man_buyer_id | man_buyer_id存在 |
请求URL
http://xx.com/bvo/getManufacturerByUserID/
请求方式
POST
参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
user_id | 是 | string | 用户ID |
返回示例
1、man_buyer_id不存在
2、man_buyer_id存在,返回相应的公司信息
代码:
{
“code”: 503,
“message”: “User doesn’t exist”
}
返回参数说明
man_buyer_id存在时返回
{
“code”: 200,
“message”: null,
“data”: {
“man_id”: 2,
“name_en”: “1”,
“name_cn”: “1”,
“gmc_report_type”: “1”,
“gmc_report_url”: “1”,
“description”: “1”,
“created_by”: “abc”,
“creation_date”: “2020-07-03”,
“last_update_by”: “abc”,
“last_update_date”: “2020-07-03”,
“call_cnt”: 0,
“remark”: null,
“sts_cd”: null,
“id”: null
}
}
参数名 | 展示 | 类型 | 说明 |
---|---|---|---|
user_id | 是 | string | 用户ID |
MAN_ID | 否 | int | 公司信息ID |
NAME_EN | 是 | string | 制造商英文名 |
NAME_CN | 是 | string | 中文名制造商 |
GMC_REPORT_TYPE | 是 | string | 品牌认证类型 1-TüV,2-UL |
GMC_REPORT_URL | 是 | string | 证书地址 |
DESCRIPTION | 否 | string | 介绍品牌公司 |
备注
3.2 公司信息新增-目前无公司信息
(1)解释
a. 当查询界面返回到无公司信息时,跳转到公司信息的新页面。公司信息记录在内man_manufacturer,自动生成man_id,man_id记入sys_user 的man_buyer_id。
(2)api
数据库
数据表 | 字段 | 外键 | 备注 |
---|---|---|---|
man_manufacturer | MAN_ID | 自动生成MAN_ID | |
sys_user | man_buyer_id | MAN_ID | |
请求URL
http://xx.com/bvo/addManufacturer/
请求方式
POST
参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
NAME_EN | 是 | string | 制造商英文名 |
NAME_CN | 是 | string | 中文名制造商 |
GMC_REPORT_TYPE | 是 | string | 品牌认证类型 1-TüV,2-UL |
GMC_REPORT_URL | 是 | string | 证书地址 |
DESCRIPTION | 否 | string | 介绍品牌公司 |
返回示例
1、新增成功
{
“code”: 200,
“message”: null
}
2、新增失败
{
“code”: 504,
}
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
备注
确认按钮点击后,调用新增接口后,继续调用公司信息查询接口,展示公司基本信息