[关闭]
@cfygaoyang 2019-11-20T08:37:37.000000Z 字数 8227 阅读 790

报价系统接口文档

未分类

API接口请求规则

  1. {
  2.     "Content-Type": "application/json",
  3.     "Authorization": "Token 1234567890"
  4. }
  6. 备注： 1234567890 为 access_token 的值

接口文档

登陆

POST /admin/auth/login/

参数 类型 必填 说明
account string 是 账号：手机/邮箱/用户名
password string 是 密码
参数 类型 必有 说明
access_token string 是 用于请求Header中的Token值
refresh_token string 是 用于刷新Token信息
expires_at string 是 access_token有效截止时间
expires_in string 是 access_token有效时间，单位：秒 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "access_token": "vHUXVVKj1hp2FP4HloMsQtMZ4T0M3hzHd8vLwDi5nDfRigEFXl",
  6.         "refresh_token": "qiecPEkCGO5kaINsUEK33TXi7B16liFBTJvK8klv2n6N41vBQZ",
  7.         "expires_at": "2019-11-21 15:17:06",
  8.         "expires_in": 604800
  9.     }
  10. }

报价单模块名称列表

GET /admin/offer/module/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "total": 2,
  6.         "pages": 1,
  7.         "current_page": 1,
  8.         "page_size": 20,
  9.         "data": [
  10.             {
  11.                 "id": 1,
  12.                 "app_id": "",
  13.                 "created": "2019-11-14 16:47:41",
  14.                 "updated": "2019-11-14 16:47:41",
  15.                 "module_name": "测试"
  16.             },
  17.             {
  18.                 "id": 2,
  19.                 "app_id": "",
  20.                 "created": "2019-11-14 16:48:29",
  21.                 "updated": "2019-11-14 16:48:29",
  22.                 "module_name": "测试"
  23.             }
  24.         ]
  25.     }
  26. }

添加报价单模块名称

POST /admin/offer/module/

参数 类型 必填 说明
module_namme string 是 模块名称 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 3,
  6.         "app_id": "",
  7.         "created": "2019-11-14 16:50:25",
  8.         "updated": "2019-11-14 16:50:25",
  9.         "module_name": "测试"
  10.     }
  11. }

获取报价单模块名称

GET /admin/offer/module/{id}/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 3,
  6.         "app_id": "",
  7.         "created": "2019-11-14 16:50:25",
  8.         "updated": "2019-11-14 16:50:25",
  9.         "module_name": "测试"
  10.     }
  11. }

编辑报价单模块名称

PUT /admin/offer/module/{id}/

参数 类型 必填 说明
module_namme string 是 模块名称 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 3,
  6.         "app_id": "",
  7.         "created": "2019-11-14 16:50:25",
  8.         "updated": "2019-11-14 16:50:25",
  9.         "module_name": "测试"
  10.     }
  11. }

删除报价单模块名称

DELETE /admin/offer/module/{id}/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {}
  5. }

报价单表单列表

GET /admin/offer/form/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "total": 1,
  6.         "pages": 1,
  7.         "current_page": 1,
  8.         "page_size": 20,
  9.         "data": [
  10.             {
  11.                 "id": 1,
  12.                 "app_id": "",
  13.                 "created": "2019-11-14 16:55:16",
  14.                 "updated": "2019-11-14 16:55:16",
  15.                 "module_id": 2,
  16.                 "form_name": "abc",
  17.                 "form_category": "input",
  18.                 "sort_index": 1,
  19.                 "placeholder": ""
  20.             }
  21.         ]
  22.     }
  23. }

添加报价单表单

POST /admin/offer/form/

参数 类型 必填 说明
module_id int 是 模块ID
form_name string 是 表单名称
form_category string 是 表单类型：如 input
sort_index int 是 表单排序
placeholder string 否 提示语 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 2,
  6.         "app_id": "",
  7.         "created": "2019-11-14 16:57:29",
  8.         "updated": "2019-11-14 16:57:29",
  9.         "module_id": 2,
  10.         "form_name": "abc",
  11.         "form_category": "input",
  12.         "sort_index": 1,
  13.         "placeholder": ""
  14.     }
  15. }

获取报价单表单

GET /admin/offer/form/{id}/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 2,
  6.         "app_id": "",
  7.         "created": "2019-11-14 16:57:29",
  8.         "updated": "2019-11-14 16:57:29",
  9.         "module_id": 2,
  10.         "form_name": "abc",
  11.         "form_category": "input",
  12.         "sort_index": 1,
  13.         "placeholder": ""
  14.     }
  15. }

编辑报价单表单

PUT /admin/offer/form/{id}/

参数 类型 必填 说明
module_id int 是 模块ID
form_name string 是 表单名称
form_category string 是 表单类型：如 input
sort_index int 是 表单排序
placeholder string 否 提示语 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 2,
  6.         "app_id": "",
  7.         "created": "2019-11-14 16:57:29",
  8.         "updated": "2019-11-14 16:57:29",
  9.         "module_id": 2,
  10.         "form_name": "abc",
  11.         "form_category": "input",
  12.         "sort_index": 1,
  13.         "placeholder": ""
  14.     }
  15. }

删除报价单表单

DELETE /admin/offer/form/{id}/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {}
  5. }

报价单配置项列表

GET /admin/offer/config/

参数 类型 必填 说明
form_id int 否 表单ID 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "total": 1,
  6.         "pages": 1,
  7.         "current_page": 1,
  8.         "page_size": 20,
  9.         "data": [
  10.             {
  11.                 "id": 1,
  12.                 "app_id": "",
  13.                 "created": "2019-11-14 17:01:15",
  14.                 "updated": "2019-11-14 17:01:15",
  15.                 "config_name": "abc",
  16.                 "config_value": 100,
  17.                 "form_id": 2
  18.             }
  19.         ]
  20.     }
  21. }

添加报价单配置项

POST /admin/offer/config/

参数 类型 必填 说明
config_name string 是 配置项名称
config_value string 是 配置项的值
form_id int 是 表单ID 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 2,
  6.         "app_id": "",
  7.         "created": "2019-11-14 17:03:31",
  8.         "updated": "2019-11-14 17:03:31",
  9.         "config_name": "abc",
  10.         "config_value": 100,
  11.         "form_id": 2
  12.     }
  13. }

获取报价单配置项

GET /admin/offer/config/{id}/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 2,
  6.         "app_id": "",
  7.         "created": "2019-11-14 17:03:31",
  8.         "updated": "2019-11-14 17:03:31",
  9.         "config_name": "abc",
  10.         "config_value": 100,
  11.         "form_id": 2
  12.     }
  13. }

编辑报价单配置项

PUT /admin/offer/form/{id}/

参数 类型 必填 说明
config_name string 是 配置项名称
config_value string 是 配置项的值
form_id int 是 表单ID 
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "id": 2,
  6.         "app_id": "",
  7.         "created": "2019-11-14 17:03:31",
  8.         "updated": "2019-11-14 17:03:31",
  9.         "config_name": "abc",
  10.         "config_value": 100,
  11.         "form_id": 2
  12.     }
  13. }

删除报价单配置项

DELETE /admin/offer/form/{id}/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {}
  5. }

报价单提交

POST /offer/

  1. {
  2.         "company": {
  3.             "company_name": "",          # 公司名称
  4.             "company_url": "",           # 公司网址
  5.             "company_address": "",       # 公司地址
  6.             "company_scale": "",         # 公司规模
  7.             "company_desc": "",          # 公司简介
  8.             "contact_department": "",    # 联系人部门
  9.             "contact_job": "",           # 联系人职位
  10.             "contact_phone": "",         # 联系人手机
  11.             "contact_email": ""          # 联系人邮箱
  12.         },
  13.         "product": {
  14.             "product_type": "",          # 产品类型
  15.             "product_category": "",      # 产品品类
  16.             "product_status": "",        # 产品状态
  17.             "product_ship_date": "",     # 上市日期
  18.             "order_num": "",             # 订单数量
  19.             "product_team": ""           # 产品团队
  20.         },
  21.         "func": [
  22.             [1, 10000],                  # 1: 功能ID, 10000: 功能价格
  23.             [11, 10000]
  24.         ]
  25. }
  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {}
  5. }

报价单功能列表

GET /offer/func/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": [
  5.         {
  6.             "module_name": "智能化产品信息",
  7.             "form_list": [
  8.                 {
  9.                     "form_name": "app接入平台",
  10.                     "form_category": "checkbox",
  11.                     "placeholder": "",
  12.                     "sort_index": 1,
  13.                     "offer_config": [
  14.                         {
  15.                             "config_name": "天猫精灵",
  16.                             "config_value": 1
  17.                         },
  18.                         {
  19.                             "config_name": "阿里云",
  20.                             "config_value": 1
  21.                         },
  22.                         {
  23.                             "config_name": "1",
  24.                             "config_value": 1
  25.                         }
  26.                     ]
  27.                 },
  28.                 {
  29.                     "form_name": "日期表单",
  30.                     "form_category": "date",
  31.                     "placeholder": "22222",
  32.                     "sort_index": 2,
  33.                     "offer_config": []
  34.                 },
  35.                 {
  36.                     "form_name": "日期保单",
  37.                     "form_category": "date",
  38.                     "placeholder": "撒大声地",
  39.                     "sort_index": 3,
  40.                     "offer_config": []
  41.                 }
  42.             ]
  43.         },
  44.         {
  45.             "module_name": "智能化需求：模组",
  46.             "form_list": [
  47.                 {
  48.                     "form_name": "单选框",
  49.                     "form_category": "radio",
  50.                     "placeholder": "",
  51.                     "sort_index": 1,
  52.                     "offer_config": [
  53.                         {
  54.                             "config_name": "单选框配置项2",
  55.                             "config_value": 2
  56.                         }
  57.                     ]
  58.                 },
  59.                 {
  60.                     "form_name": "多选框",
  61.                     "form_category": "checkbox",
  62.                     "placeholder": "",
  63.                     "sort_index": 2,
  64.                     "offer_config": []
  65.                 }
  66.             ]
  67.         },
  68.         {
  69.             "module_name": "智能化需求：APP",
  70.             "form_list": []
  71.         }
  72.     ]
  73. }

报价单列表

GET /offer/list/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "total": 3,
  6.         "pages": 1,
  7.         "current_page": 1,
  8.         "page_size": 20,
  9.         "data": [{
  10.             "_id": "5dd3c6fc749afb967de455d4",
  11.             "company": {
  12.                 "company_name": "1",
  13.                 "company_url": "1",
  14.                 "company_address": "1",
  15.                 "company_scale": "50-150人",
  16.                 "company_desc": "1",
  17.                 "contact_department": "1",
  18.                 "contact_job": "11",
  19.                 "contact_phone": "1",
  20.                 "contact_email": "1",
  21.                 "order_num": "10-50K",
  22.                 "product_team": "5-20人",
  23.                 "remarks": "1111"
  24.             }
  25.         }, {
  26.             "_id": "5dd2489f749afb967de455d2",
  27.             "company": {
  28.                 "company_name": "公司名称",
  29.                 "company_url": "公司网址",
  30.                 "company_address": "公司地址",
  31.                 "company_scale": "50人以下",
  32.                 "contact_department": "联系人部门",
  33.                 "contact_job": "联系人职位",
  34.                 "contact_phone": "联系人手机",
  35.                 "contact_email": "联系人邮箱",
  36.                 "order_num": "10K以下",
  37.                 "product_team": "5人以下"
  38.             }
  39.         }, {
  40.             "_id": "5dce5acfe26b4909199edf8c",
  41.             "company": {
  42.                 "company_name": "",
  43.                 "company_url": "",
  44.                 "company_address": "",
  45.                 "company_scale": "",
  46.                 "company_desc": "",
  47.                 "contact_department": "",
  48.                 "contact_job": "",
  49.                 "contact_phone": "",
  50.                 "contact_email": ""
  51.             }
  52.         }]
  53.     }
  54. }

报价单详情

GET /offer/detail/{_id}/

  1. {
  2.     "code": 0,
  3.     "message": "success",
  4.     "data": {
  5.         "func": [{
  6.             "module_name": "智能化需求：模组",
  7.             "form_list": [{
  8.                 "form_name": "模块价格",
  9.                 "func": []
  10.             }, {
  11.                 "form_name": "联网方式",
  12.                 "func": []
  13.             }, {
  14.                 "form_name": "PCAB封装",
  15.                 "func": []
  16.             }, {
  17.                 "form_name": "工作温度",
  18.                 "func": []
  19.             }, {
  20.                 "form_name": "尺寸",
  21.                 "func": []
  22.             }, {
  23.                 "form_name": "类别",
  24.                 "func": []
  25.             }, {
  26.                 "form_name": "支持平台",
  27.                 "func": []
  28.             }, {
  29.                 "form_name": "资质认证",
  30.                 "func": []
  31.             }, {
  32.                 "form_name": "功能定制",
  33.                 "func": []
  34.             }]
  35.         }, {
  36.             "module_name": "智能化需求：APP",
  37.             "form_list": [{
  38.                 "form_name": "用户账号",
  39.                 "func": []
  40.             }, {
  41.                 "form_name": "设备管理",
  42.                 "func": []
  43.             }, {
  44.                 "form_name": "设备控制",
  45.                 "func": []
  46.             }, {
  47.                 "form_name": "设备监测",
  48.                 "func": []
  49.             }, {
  50.                 "form_name": "数据统计",
  51.                 "func": []
  52.             }, {
  53.                 "form_name": "智能场景",
  54.                 "func": []
  55.             }, {
  56.                 "form_name": "咨询反馈",
  57.                 "func": []
  58.             }, {
  59.                 "form_name": "其他",
  60.                 "func": []
  61.             }, {
  62.                 "form_name": "平台APP接入",
  63.                 "func": []
  64.             }]
  65.         }, {
  66.             "module_name": "智能化需求：云平台",
  67.             "form_list": [{
  68.                 "form_name": "云平台选择",
  69.                 "func": []
  70.             }, {
  71.                 "form_name": "工作人员账号",
  72.                 "func": []
  73.             }, {
  74.                 "form_name": "项目管理",
  75.                 "func": []
  76.             }, {
  77.                 "form_name": "固件管理",
  78.                 "func": []
  79.             }, {
  80.                 "form_name": "设备激活",
  81.                 "func": []
  82.             }, {
  83.                 "form_name": "设备活跃",
  84.                 "func": []
  85.             }, {
  86.                 "form_name": "告警中心",
  87.                 "func": []
  88.             }, {
  89.                 "form_name": "用户概览",
  90.                 "func": []
  91.             }, {
  92.                 "form_name": "用户搜索",
  93.                 "func": []
  94.             }, {
  95.                 "form_name": "用户列表",
  96.                 "func": []
  97.             }, {
  98.                 "form_name": "用户新增",
  99.                 "func": []
  100.             }, {
  101.                 "form_name": "用户活跃",
  102.                 "func": []
  103.             }, {
  104.                 "form_name": "数据大屏",
  105.                 "func": []
  106.             }, {
  107.                 "form_name": "FAQ",
  108.                 "func": []
  109.             }, {
  110.                 "form_name": "操作日志",
  111.                 "func": []
  112.             }, {
  113.                 "form_name": "电商功能",
  114.                 "func": []
  115.             }, {
  116.                 "form_name": "功能扩展",
  117.                 "func": []
  118.             }]
  119.         }],
  120.         "company": {
  121.             "company_name": "1",
  122.             "company_url": "1",
  123.             "company_address": "1",
  124.             "company_scale": "50-150人",
  125.             "company_desc": "1",
  126.             "contact_department": "1",
  127.             "contact_job": "11",
  128.             "contact_phone": "1",
  129.             "contact_email": "1",
  130.             "order_num": "10-50K",
  131.             "product_team": "5-20人",
  132.             "remarks": "1111"
  133.         },
  134.         "product": {
  135.             "product_type": "智能家装",
  136.             "product_category": "1",
  137.             "product_status": "正在开发",
  138.             "product_ship_date": "2019-11-22T10:41:42.970Z"
  139.         },
  140.         "price": 0
  141.     }
  142. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注