# AXF **Repository Path**: ncepu_liudong/AXF ## Basic Information - **Project Name**: AXF - **Description**: No description available - **Primary Language**: Python - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-09-02 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AXF **bilibili上的学习项目** ## 爱鲜蜂接口文档 ### 一、首页接口 - 简要描述：** - 首页的轮播、推荐，每日生鲜、便利店、商品展示 - 请求地址： - `/api/goods/home/` - 请求方式 - get - 请求参数：无 - 返回示例： ``` { 'code': 200, 'msg': '请求成功', 'data':{ 'main_wheels':{}, 'main_navs':{}, 'main_shops':{}， 'main_shows':{}, 'main_mustbuys':{} } } ``` - **返回参数说明** ### 二、闪购 #### 1.商品类型列表 - **简要描述：** - 获取商品类型信息 - 请求地址： - `/api/goods/foodtype/` - 请求方式 - get - 请求参数： - 返回示例： ``` { 'code': 200, 'msg': '请求成功', 'data': [{'id': 1, 'typeid':104749, 'typename': '热销榜', 'childtypenames':'全部分类:0', 'typesort': 1}, ] } ``` - **返回参数说明 #### 2.商品列表 - **简要描述：** - 商品列表 - 请求地址： - `/api/goods/market/` - 请求方式 - get - 请求参数： ``` {'typeid': ['104749'], 'childcid': ['0'], 'order_rule': ['0']} ``` | 参数名 | 必选 | 类型 | 默认值 | 说明 | | ---------- | ---- | ------ | ------ | ---------- | | typeid | 是 | string | 无 | 商品类型id | | childcid | 是 | string | 无 | 子类id | | order_rule | 是 | string | 无 | 排序规则 | - 返回示例： ``` { 'code': 200, 'msg': '请求成功', 'data': { 'goods_list': [OrderedDict([('id', 495), ('productid', 119570), ('productimg', '://img01.bqstatic.com/upload/goods/201/703/1318/20170313185620_821516.jpg@200w_200h_90Q'), ('productname', '麻辣味鲅鱼'), ductlongname', '麻辣味鲅鱼32g'), ('isxf', True), ('pmdesc', True), ('specifics', '32g'), ('price', 1.0), ('marketprice', 1('categoryid', 104749), ('childcid', 103543), ('childcidname', '膨化食品'), ('dealerid', 4858), ('storenums', 50), ('produm', 100003541)])], 'order_rule_list: [{'order_name': '综合排序', 'order_value': 0}, {'order_name': '价格升序', 'order_value': 1}, {'order_name': '价格降序', ': 2}, {'order_name': '销量升序', 'order_value': 3}, {'order_name': '销量降序', 'order_value': 4}], 'foodtype_childname_list': [{'child_name':全部分类', 'child_value': '0'}] } } ``` goods_list: 商品列表; order_rule_list: 排序列表； foodtype_childname_list：商品子类列表 ### 三、购物车 #### 1.添加商品 - **简要描述：** - 将商品添加到购物车 - 请求地址： - `/api/cart/cart/add_cart/` - 请求方式 - post - 请求参数： | 参数名 | 必选 | 类型 | 默认值 | 说明 | | ------- | ---- | ------ | ------ | -------- | | token | 是 | string | 无 | 登录标示 | | goodsid | 是 | int | 无 | 商品id | - 返回示例： ``` { 'code': 200, 'msg': '请求成功', 'data': {'c_goods_num': 1} } ``` - **返回参数说明** - c_goods_num:商品数量 #### 2.减少商品 - **简要描述：** - 减少购物车中商品的数量 - 请求地址： - `/api/cart/cart/sub_cart/` - 请求方式 - post - 请求参数： | 参数名 | 必选 | 类型 | 默认值 | 说明 | | ------- | ---- | ------ | ------ | -------- | | token | 是 | string | 无 | 登录标示 | | goodsid | 是 | int | 无 | 商品id | - 返回示例： ``` { 'code': 200, 'msg': '请求成功', 'data': {'c_goods_num': 1} #根据数据库里的值决定 } ``` - **返回参数说明** - c_goods_num:商品数量 #### 3.取消选中商品 - **简要描述：** - 取消选中商品 - 请求地址： - `/api/cart/cart/18/` - 请求方式 - patch - 请求参数： | 参数名 | 必选 | 方式 | 类型 | 默认值 | 说明 | | ------ | ---- | ----- | ------ | ------ | -------- | | token | 是 | patch | string | 无 | 登录标示 | | id | 是 | 路由 | int | 无 | 商品id | - 返回示例： ``` # 请求成功 { 'code': 200, 'msg': '请求成功', 'data': {} } # 请求失败 { 'code': 107, 'msg': '请求失败', 'data': {} } ``` #### 4.购物车展示 - **简要描述：** - 将商品添加到购物车 - 请求地址： - `/api/cart/cart/` - 请求方式 - get - ###### 请求参数： | 参数名 | 必选 | 类型 | 默认值 | 说明 | | ------ | ---- | ------ | ------ | -------- | | token | 是 | string | 无 | 登录标示 | - 返回示例： ``` { 'code':200, 'msg':'请求成功', 'data':{ 'title': '购物车', 'is_all_select': True, 'total_price': '56.20', 'carts': [OrderedDict([('id', 1), ('c_is_select', e), ('c_goods_num', 1), ('c_goods', OrderedDict([('id', 495), ('productid', 119570), ('productimg', 'http://image.codingfans.cc/daily.jpg'), ('productname', '麻辣味鲅鱼'), ('productlongname', '麻辣味鲅鱼32g'), ('isxf', True), ('pmdesc', True), s', '32g'), ('price', 1.0), ('marketprice', 1.0), ('categoryid', 104749), ('childcid', 103543), ('childcidname', '膨化食品('dealerid', 4858), ('storenums', 50), ('productnum', 100003541)]))]), ] } } ``` - **返回参数说明** - carts:购物车中所有商品 #### 5.订单 - **简要描述：** - 订单生成 - 请求地址： - `/api/orders/orders/?token=sdsdfsdfsdfkj` - 请求方式 - post - 请求参数： | 参数名 | 必选 | 类型 | 默认值 | 说明 | | ------ | ---- | ------ | ------ | -------- | | token | 可选 | string | 无 | 登录标示 | - 返回示例： ``` { 'code': 200, 'msg': '请求成功', 'data': {'order_id': 1} } ``` - **返回参数说明** #### 6.订单展示 - **简要描述：** - 显示订单 - 请求地址： - `/api/orders/orders/` - 请求方式 - get - 请求参数： | 参数名 | 必选 | 类型 | 默认值 | 说明 | | -------- | ---- | ------ | ------ | -------- | | token | 是 | string | 无 | 登录标示 | | o_status | 可选 | string | all | 订单状态 | - 返回示例： ``` { "code": 200, "msg": "请求成功", "data": [ { "id": 1, "o_price": 13.0, "o_time": "2020-03-30T08:20:07.893283", "o_status": 0, "o_user": 13, "order_goods_info": [ { "id": 1, "o_goods": { "id": 388, "productid": 3795, "productimg": "http://image.codingfans.cc/oil.jpg", "productname": "", "productlongname": "龙门米醋480ml", "isxf": 0, "pmdesc": 0, "specifics": "480ml", "price": 6.0, "marketprice": 6.0, "categoryid": 103569, "childcid": 103571, "childcidname": "厨房调味", "dealerid": 4858, "storenums": 200, "productnum": 37 }, "o_goods_num": 1, "o_order": 1 }, { "id": 2, "o_goods": { "id": 387, "productid": 4692, "productimg": "http://image.codingfans.cc/oil.jpg", "productname": "王致和,大块,腐乳,粮油副食,调味品", "productlongname": "王致和大块腐乳340g", "isxf": 0, "pmdesc": 0, "specifics": "340g", "price": 7.0, "marketprice": 6.0, "categoryid": 103569, "childcid": 103572, "childcidname": "调味酱", "dealerid": 4858, "storenums": 200, "productnum": 47 }, "o_goods_num": 1, "o_order": 1 } ] }, ] } ``` - **返回参数说明** ### 四、用户管理 #### 1.用户信息 - **简要描述：** - 获取用户基本信息 - 请求地址： - `/api/user/auth/?token=sdfuiiuiusidf39893` - 请求方式 - get - 请求参数： | 参数名 | 必选 | 类型 | 默认值 | 说明 | | ------ | ---- | ------ | ------ | -------- | | token | 是 | string | 无 | 登录标示 | - 返回示例： ``` { 'code': 200, 'msg': '请求成功', 'data': { 'user_info': {'id': 1, 'u_username': 'csl', 'u_password': 'pbkdf2_sha256$150000$rLXATbbf$Fwt4l0a4mzVjnxO1QFKTHDiMP0c+NZRow64TUeYGCPY=', 'u_email': 'csl@126.com'}, 'orders_not_pay_num': 0, # 待付款 'orders_not_send_num': 0 # 待收货 } } ``` - **返回参数说明** #### 2.用户登录 - **简要描述：** - 验证用户身份 - 请求地址： - `/api/user/auth/login/` - 请求方式 - post - 请求参数：无 - 返回示例： ``` 登录成功 { 'code': 200, 'msg': '请求成功', 'data': { 'user_id': 1, 'token': '9ba78bca648e42d384fec86e62b4efa7' } } # 登录失败 { 'code': 1004, 'msg': '请求参数校验失败', 'data': {} } ``` - **返回参数说明** #### 3.用户注册 - **简要描述：** - 注册 - 请求地址： - `/api/user/auth/register/` - 请求方式 - post - 请求参数： | 参数名 | 必选 | 类型 | 默认值 | 说明 | | ----------- | ---- | ------ | ------ | -------- | | u_username | 是 | string | 无 | 用户名 | | u_password | 是 | string | 无 | 密码 | | u_password2 | 是 | string | 无 | 确认密码 | | u_email | 是 | string | 无 | 邮箱 | - 返回示例： ``` 注册成功 { 'code': 200, 'msg': '请求成功', 'data': { 'user_id': 1, } } # 注册失败 { 'code': 1004, 'msg': '请求参数校验失败', 'data': {} } ```