# androidAPI

**Repository Path**: sein_china/androidAPI

## Basic Information

- **Project Name**: androidAPI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-04-12
- **Last Updated**: 2021-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#安卓课设后台API
##目录
* [用户](#用户)
    * [用户注册](#用户注册)
    * [用户登陆](#用户登陆)
* [店铺](#店铺)
    * [店铺列表](#店铺列表)
    * [店铺详情](#店铺详情)
    * [店铺评价](#店铺评价)
    * [店铺菜品](#店铺菜品)
* [关键字查找](#关键字查找)
* [地址](#地址)
    * [查询地址](#查询地址)
    * [新增地址](#新增地址)
    * [更新地址](#更新地址)
    * [删除地址](#删除地址)
* [订单](#订单)
    * [新增订单](#新增订单)
    * [修改订单状态](#修改订单状态)
    * [获取用户订单信息](#获取用户订单信息)
    

---
####只能接单退单的web版商家中心
http://dirtytao.com/androidAPI/storecenter
---
##用户
####用户注册
* URL
```
http://dirtytao.com/androidAPI/user/signup
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| username   | 用户名   |
| password   | 密码   |


* 返回结果示例
```json
{"status":"success"}
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| status   | 用户名存在：**fail** ,注册成功： **success**  |


---
####用户登陆
* URL
```
http://dirtytao.com/androidAPI/user/signin
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| username   | 用户名   |
| password   | 密码   |

* 返回结果示例
```json
{"status":"success"}
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| status   | 用户名或密码错误：**fail** ,登陆成功： **success**  |

---
##店铺
####店铺列表
* URL
```
http://dirtytao.com/androidAPI/store/storelist
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| page   | 第几页数据   |
| limit   | 每页数量  |


* 返回结果示例
```json
[{"id":"11","username":"bbbb","shop_name":"\u6e05\u84b8\u83dc","shop_address":"\u6d59\u6c5f\u554a","shop_phone":"1232131312","first_type":"\u7279\u8272\u83dc","second_type":"\u6e05\u771f\u83dc","price_tosend":"15","discount":"20-8","shop_owner":"sdsad ","id_card":null,"longitude":"119.735539","latitude":"30.262074","shop_license":"2423424","shop_description":"hahahahhhaha","shop_notice":"\u6e05\u771f\u6e05\u84b8\u83dc\uff0c\u8ba9\u4f60\u6e05\u7eaf\uff01","score":"4.495029821073559","sell_num":"503","ave_sendtime":"50"}]
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| id   | 店铺id  |
| username   | 商家用户名  |
| shop_name  | 店铺名称  |
| shop_address   | 店铺地址  |
| shop_phone   | 店铺电话  |
| first_type   | 店铺第一分类  |
| second_type   | 店铺第二分类  |
| price_tosend   | 起送价  |
| discount   | 优惠活动  |
| shop_owner   | 店主姓名  |
| id_card   | 略  |
| longitude   | 店铺经度  |
| latitude   | 店铺纬度  |
| shop_license  | 经营证书号  |
| shop_description  | 店铺描述  |
| shop_notice  | 店铺公告  |
| score  | 店铺评分  |
| sell_num  | 店铺销量  |
| ave_sendtime  | 平均配送时间  |

---

#### 店铺详情
* URL
```
http://dirtytao.com/androidAPI/Store/storedetail
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| sid   | 店铺id  |


* 返回结果示例

```json
{
    "id": "12",
    "username": "my",
    "shop_name": "方源骨头饭",
    "shop_address": "农大西门商业街303号",
    "shop_phone": "13251013453",
    "first_type": "快餐小吃",
    "second_type": "中式简餐",
    "price_tosend": "15",
    "discount": "20-8",
    "shop_owner": "my",
    "id_card": null,
    "longitude": "119.735539",
    "latitude": "30.262074",
    "shop_license": "330185600310278",
    "shop_description": "myshop",
    "shop_notice": "【营业执照号】330185600310278\n\n各位同学，请务必“备注短号”！！！中午和晚上忙的时候用餐高峰点希望您提前一小时点餐，手机上网同样能点。短号！！！短号对外卖小哥来说真滴很重要很重要很重要！",
    "score": "3.997008973080758",
    "sell_num": "1",
    "ave_sendtime": "40",
    "dishtype": [
        {
            "id": "66",
            "type": "饮料"
        }
    ]
}
```

| 参数  | 说明|
| ---------- | -----------|
| ...   | 店铺详情部分与上面相同  |
| dishtype  | 菜品类型|
| dish  | 菜品|
| dish_name  | 菜品名称|
| sell_num  | 菜品销量|
| score  | 菜品评分|
| price  | 菜品价格|

#### 店铺评价

* URL
```
http://dirtytao.com/androidAPI/Store/comments
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| sid   | 店铺id  |


* 返回结果示例
```json
[
    {
        "id": "1",
        "comments": "还不错哦",
        "username": "123",
        "score": "4.8",
        "order_id": "20131212121212",
        "time": "2015-09-08 21:22:51"
    },
    {
        "id": "2",
        "comments": "不好吃",
        "username": "123",
        "score": "1.3",
        "order_id": "20131111111111",
        "time": "2015-12-14 21:23:02"
    }
]
```
| 参数  | 说明|
| ---------- | -----------|
| id  | 评价id|
| comments  | 评价内容|
| username  | 评价用户名|
| score  | 评分|
| order_id  | 订单号|
| time  | 评价时间|

#### 店铺菜品
* URL
```
http://dirtytao.com/androidAPI/Store/storedish
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| sid   | 店铺id  |

* 返回结果示例
```
[
    {
        "id": "89",
        "dish_name": "海带排骨（小份）",
        "store_id": "12",
        "sell_num": "0",
        "type_id": "63",
        "score": null,
        "price": "13"
    },
    {
        "id": "90",
        "dish_name": "木耳排骨（小份）",
        "store_id": "12",
        "sell_num": "0",
        "type_id": "63",
        "score": null,
        "price": "13"
    }]
```

| 参数  | 说明|
| ---------- | -----------|
| id  | 菜品id|
| dish_name  | 菜品名称|
| sell_num  | 菜品销量|
| type_id  | 类型id|
| score  | 菜品评分|
| price  | 菜品价格|


## 关键字查找
* URL
```
http://dirtytao.com/androidAPI/Search
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| key   | 搜索关键字   |


* 返回结果示例
```json
{
        "id": "10",
        "shop_name": "黄焖鸡米饭",
        "discount": "20-8",
        "score": "3.188679245283019",
        "sell_num": "53",
        "ave_sendtime": "45",
        "num": "5",
        "dish": [
            {
                "dish_name": "黄焖鸡爪饭"
            },
            {
                "dish_name": "黄焖鸡腿饭"
            },
            {
                "dish_name": "黄焖鸡翅饭"
            }
        ]
    }   
```  
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| id  |店铺id|
| shop_name  | 店铺名称|
| discount  | 店铺优惠|
| score  | 店铺评分|
| sell_num  | 店铺销量|
| ave_sendtime  | 店铺平均配送时间|
| num  | 该店铺搜索到菜的数量，此字段为0即代表搜索到的店名符合关键字|
| dish_name  | 该店铺搜索到的菜的名称|
| **_备注_**  | 搜索到的菜只显示前3个以作展示|


## 地址
#### 查询地址
* URL
```
http://dirtytao.com/androidAPI/Address
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| username   | 用户名   |



* 返回结果示例
```json
[
    {
        "id": "1",
        "address": "杭州市临安市浙江农林大学-B4305",
        "phone": "619234",
        "name": "林利豪\n"
        },
    {
        "id": "3",
        "address": "杭州市临安市浙江农林大学-B4301",
        "phone": "13251013453",
        "name": "许逗比"
    }
]
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| id   | 地址id  |
| address   | 地址  |
| phone   | 联系电话  |
| name   | 联系姓名  |
#### 新增地址
* URL
```
http://dirtytao.com/androidAPI/Address/add
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| username   | 用户名   |
| address   | 地址   |
| phone   | 联系电话   |
| name   | 联系人   |



* 返回结果示例
```json
{"status":"success","id":"40"}
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| status   | 操作失败：**fail** ,操作成功： **success**  |
| id   | 新增的地址id,添加失败则省略  |

#### 更新地址
* URL
```
http://dirtytao.com/androidAPI/Address/update
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| id   | 地址id   |
| address   | 地址   |
| phone   | 联系电话   |
| name   | 联系人   |



* 返回结果示例
```json
{"status":"success"}
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| status   | 操作失败：**fail** ,操作成功： **success**  |

#### 删除地址
* URL
```
http://dirtytao.com/androidAPI/Address/delete
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| id   | 地址id   |



* 返回结果示例
```json
{"status":"success"}
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| status   | 操作失败：**fail** ,操作成功： **success**  |

---
## 订单
#### 新增订单
* URL
```
http://dirtytao.com/androidAPI/Order/add
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| address_id   | 送货地址id   |
| dish_id_string   | 订单菜品组成的字符串，格式为：菜品id:数量-菜品id:数量-菜品id:数量   |
| store_id   | 店铺id   |
| remark   | 订单备注   |
| payment_type   | 支付方式   |
| username   | 订单用户   |
| discount_result   | 折扣结果，如‘-¥9.0’或‘不满足优惠要求’,用于直接显示在订单详情上   |
| total_price   | 满减后的最终订单价格   |


* 返回结果示例
```json
{"status":"success","id":"1605251956388087"}
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| status   | 操作失败：**fail** ,操作成功： **success**  |
| id   | 新增的订单id,添加失败则省略  |

---
#### 修改订单状态
* URL
```
http://dirtytao.com/androidAPI/Order/update
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| id   | 订单id   |
| state   | 修改的状态   |

* 订单状态说明


| 状态  | 说明|
| ---------- | -----------|
| 1   | 下订单  |
| 10   | 取消订单  |
| 11   | 支付成功  |
| 110   | 支付成功后，商家拒绝接单  |
| 111   | 支付成功后，商家接单  |
| 1111   | 完成订单  |
| 1110   | 商家接单后申请退款  |
| 11101   | 商家同意退款  |
| 11100   | 商家拒绝退款  |
| 111001   | 商家拒绝退款后继续配送完成订单  |



* 返回结果示例
```json
{"status":"success"}
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| status   | 操作失败：**fail** ,操作成功： **success**  |

---
#### 获取用户订单信息
* URL
```
http://dirtytao.com/androidAPI/Order/orderlist
```
* HTTP请求方式
```
POST
```
* 请求参数

| 参数  | 说明|
| ---------- | -----------|
| username   | 用户名   |
| state   | 订单状态，0代表所有状态的订单   |


* 返回结果示例
```json
[
    {
        "id": "1605252058526444",
        "setorder_time": "2016-05-25 20:05:52",
        "state": "111",
        "time_from_setorder": "1464181132-1464182437-1464182455",
        "address_id": "1",
        "dish_id_string": "dish_id_string",
        "store_id": "10",
        "remark": "remark",
        "payment_type": "0",
        "username": "zhangtao",
        "discount_result": "discount_result",
        "total_price": "666"
    },
    {
        "id": "20140212121212",
        "setorder_time": "2015-07-14 19:53:35",
        "state": "1",
        "time_from_setorder": "0",
        "address_id": "1",
        "dish_id_string": "8:1",
        "store_id": "40",
        "remark": "hi",
        "payment_type": "1",
        "username": "zhangtao",
        "discount_result": "不满足优惠要求",
        "total_price": "13"
    }
]
```
* 返回字段说明

| 参数  | 说明|
| ---------- | -----------|
| id   | 订单id  |
| setorder_time   | 下单时间  |
| state   | 订单状态  |
| time_from_setorder   | 状态改变的时间戳，包括下单时的时间戳，用'-'分割  |
| address_id   | 配送地址id  |
| dish_id_string   | 订单菜品组成的字符串，格式为：菜品id:数量-菜品id:数量-菜品id:数量   |
| store_id   | 商店id  |
| remark   | 订单备注  |
| payment_type   | 支付方式  |
| username   | 用户名  |
| discount_result   | 折扣结果  |
| total_price   | 满减后的最终订单价格  |




---