锐单电子商城 , 一站式电子元器件采购平台!
  • 电话:400-990-0325

3.1 公司信息查询(改)接口设计参考 (api设计)

时间:2023-04-20 20:37:00 gmc功率变送器sineax

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, “message”: “Add operation failed”
}

返回参数说明
参数名 类型 说明
备注

确认按钮点击后,调用新增接口后,继续调用公司信息查询接口,展示公司基本信息

锐单商城拥有海量元器件数据手册IC替代型号,打造电子元器件IC百科大全!

相关文章