•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

•  

     

演示

  所有的請求 介面都會響應統一的資料格式（ json 格式）

  eg

 { "status_code": 0,  // 所有的status_code 為0 代表成功 "message": null,  //返回響應的提示訊息 "data": { "data_filed": "asd" // 前段需要展示的資料 } }

首頁介面

獲取使用者 token

  介面說明

因為小程式不使用 cookie 所以需要使用者登入後操作的操作都需要帶上後端

介面返回的 token

  請求方式

post

  請求引數

引數名	型別	是否必須
auth_code	string	是

  請求 url

user/gettoken

  相應資料

{ "status_code": 0, "message": null, "data": { "token": "123123123123123" } }

獲取首頁資料

  介面說明

獲取首頁展示資料

  請求地址

/index

  請求引數

無

  響應資料

{ "status_code": 0, "message": "", "data": { "banner": ["1.jpg", "1.jpg", "1.jpg"],//輪播圖 "message": [{ "type": 1, //1 返現 2  反捲 "phone": "150 302203740", "price": "200 \u5143" }, { "type": 2, "phone": "150 302203740", "price": "200 \u5143" }], "excellent_goods": [{ // // 名優商品 "product_id": 1, // 商品id "pic_url": "http:\/\/\/1.jpg", "price": "128.00 \u5143" 價格 }, { "product_id": 1, "pic_url": "http:\/\/\/1.jpg", "price": "128.00 \u5143" }, { "product_id": 1, "pic_url": "http:\/\/\/1.jpg", "price": "128.00 \u5143" }], "special_goods": [{ "product_id": 1, "pic_url": "http:\/\/\/1.jpg", "price": "128.00 \u5143" }, { "product_id": 1, "pic_url": "http:\/\/\/1.jpg", "price": "128.00 \u5143" }, { "product_id": 1, "pic_url": "http:\/\/\/1.jpg", "price": "128.00 \u5143" }] } }

獲取商品詳情頁

  介面說明

獲取商品詳情頁資料

  請求地址

/goods/info

  請求引數

product_id 首頁資料中的 商品 id

  響應資料

{ "status_code": 0, "message": "", "data": { "product_info": { //商品資訊 "product_id": 12, "product_name": "小米 手機", "stock": "12 件", "sales_volume": "1222 件", "description": "詳情", "price": "123元", "banner": ["1,jpg", "2.jpg"], "video": "123.mp4", "content": ["1,jpg", "2.jpg"], }, "is_collection": "1", 是否收藏 1 收藏 2 未收藏, "flag": "1",  1 特推 2 名優 "product_attr": [{ "product_id": 2, "attr_name": "顏色", "attr_values": ["紅色", "藍色", "粉色"] }, { "product_id": 2, "attr_name": "容量", "attr_values": ["12G", "24G", "48G"] }], "product_value": { "12G,粉色": { "product_id": 2, "suk": "12G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "12G,紅色": { "product_id": 2, "suk": "12G,紅色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "12G,藍色": { "product_id": 2, "suk": "12G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "24G,粉色": { "product_id": 2, "suk": "24G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "24G,紅色": { "product_id": 2, "suk": "24G,紅色", "stock": 0, "sales": 12, "price": "100.00", "image": "}, "24G,藍色": { "product_id": 2, "suk": "24G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,粉色": { "product_id": 2, "suk": "48G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,紅色": { "product_id": 2, "suk": "48G,紅色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,藍色": { "product_id": 2, "suk": "48G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "} }, "comment": { "sum": "12", "good_comment": "99%", "list": [{ "name": "zhangsan", "head_pic": "頭像地址", "level": "1", "sku": "紅色 128G", "pic": ["1.jpg"], "time": "2019-08-05", "content": "不錯" }] } } }

評論列表

  請求地址

/comment/list

  請求方式

get

  請求引數

product_id 必須

page 不傳預設顯示第一頁

  響應資料

{ "status_code": 0, "message": "", "data": { "good_comment_rate": " 好評率", "all_comment_num": "所有評論數", "good_comment": "好評數", "middle_comment": "中評數", "bad_comment": "差評數", "total_page": "總頁數", "comment_list": [{ "head_pic": "頭像地址", "start_num": "星星數", "name": "名字", "date": "時間", "sku": "規格", "content": "評論內容", "pic": ["圖片1"], "reply": { "name": "回覆人名字", "content": "回覆內容" } }] } }

獲取商品搜尋歷史

  請求地址

/goods/history

  請求引數

無

  請求方式

get

  響應資料

{ "status_code": 0, "message": "", "data": ["水果", "手機"] }

搜尋商品

  請求地址

/goods/serach

  請求引數

goods_name 商品名字 type 搜尋型別 不傳預設 綜合 sale 代表銷量 new 代表最新 最多顯示 30 條

  請求方式

get

  響應資料

{ "status_code": 0, "message": "", "data": [{ "name": "商品名", "pic": "商品圖片", "price": "商品價格", "sales": "商品銷量", "product_attr": [{ "product_id": 2, "attr_name": "顏色", "attr_values": ["紅色", "藍色", "粉色"] }, { "product_id": 2, "attr_name": "容量", "attr_values": ["12G", "24G", "48G"] }], "product_value": { "12G,粉色": { "product_id": 2, "suk": "12G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "12G,紅色": { "product_id": 2, "suk": "12G,紅色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "12G,藍色": { "product_id": 2, "suk": "12G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "24G,粉色": { "product_id": 2, "suk": "24G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "24G,紅色": { "product_id": 2, "suk": "24G,紅色", "stock": 0, "sales": 12, "price": "100.00", "image": "}, "24G,藍色": { "product_id": 2, "suk": "24G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,粉色": { "product_id": 2, "suk": "48G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,紅色": { "product_id": 2, "suk": "48G,紅色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,藍色": { "product_id": 2, "suk": "48G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "} } }] } 
獲取商品分類
 請求地址
/goods/class
 請求方式
get
 請求引數
無
 響應資料
{ "status_code": 0, "message": "", "data": [{ "class_name": "分類名字", "class_id": "分類id" }] }

獲取商品透過分類 id

  請求地址

/goods/class

  請求方式

get

  請求引數

class_id 必填 page 不必填 預設為 1

  響應資料

{ "status_code": 0, "message": "", "data": { "goods": { "name": "商品名", "pic": "商品圖片", "price": "商品價格", "sales": "商品銷量", "product_attr": [{ "product_id": 2, "attr_name": "顏色", "attr_values": ["紅色", "藍色", "粉色"] }, { "product_id": 2, "attr_name": "容量", "attr_values": ["12G", "24G", "48G"] }], "product_value": { "12G,粉色": { "product_id": 2, "suk": "12G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "12G,紅色": { "product_id": 2, "suk": "12G,紅色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "12G,藍色": { "product_id": 2, "suk": "12G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "24G,粉色": { "product_id": 2, "suk": "24G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "24G,紅色": { "product_id": 2, "suk": "24G,紅色", "stock": 0, "sales": 12, "price": "100.00", "image": "}, "24G,藍色": { "product_id": 2, "suk": "24G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,粉色": { "product_id": 2, "suk": "48G,粉色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,紅色": { "product_id": 2, "suk": "48G,紅色", "stock": 12, "sales": 0, "price": "100.00", "image": "}, "48G,藍色": { "product_id": 2, "suk": "48G,藍色", "stock": 12, "sales": 0, "price": "100.00", "image": "} } }, "total_page": "總頁數" } }

商品收藏

  請求地址

/goods/collection

  請求方式

get

  請求引數

product_id 商品 id

  響應資料

{ "status_code": 0,  //   代表成功  "message": null,  //返回響應的提示訊息 "data": {   } }

商品取消收藏

  請求地址

/goods/uncollection

  請求方式

get

  請求引數

product_id 商品 id

  響應資料

{ "status_code": 0,  //   代表成功  "message": null,  //返回響應的提示訊息 "data": {   } }

新增到購物車

  請求地址

/goods/addcart

  請求方式

post

  請求引數

prodect_id 必傳引數 商品 id num 必傳引數 商品數量 unique 商品的唯一識別碼 也就是說 如果選擇了商品的屬性 那麼此引數必須

  響應資料

  { "status_code": 0,  //   代表成功  "message": null,  //返回響應的提示訊息 "data": {   }

我的購物車

  請求地址

/goods/cartlist

  請求方式

post

  請求引數

prodect_id 必傳引數 商品 id num 必傳引數 商品數量 unique 商品的唯一識別碼 也就是說 如果選擇了商品的屬性 那麼此引數必須

  響應資料

{ status_code: 0, message: "", data: { cart_count: "購物車數量", cart_info: [{ cart_id: "購物車id", num: "商品數量", product_id: "商品id", product_name: "商品名字", pic: "商品圖片", price: "商品價格"， sku: "商品sku" }] } }

變化購物車數量

  請求地址 /goods/changecart

  請求引數 type ： add 為增加 reduce 為減少

cart_id

- 請求方式

post

  響應資料

 { "status_code": 0,  //   代表成功  "message": null,  //返回響應的提示訊息 "data": {   }

刪除購物車

  請求地址

goods/delcart

  請求引數

cart_id

  請求方式

post

  響應資料

{ "status_code": 0,  //   代表成功  "message": null,  //返回響應的提示訊息 "data": {   }

使用者點選立即購買下單

  請求地址

/order/makecart

  請求方式

post

  請求引數

product_id 必填

uninq 如果選擇了屬性 那麼此引數必填

num 商品數量

  響應資料

{ status_code: 0, message: "", data: { cart_id: "購物車id" } }

使用者建立訂單頁面

  請求地址

/order/confirmorder

  請求方式

get

  請求引數

cart_id 購物車 id 用逗號隔開

  響應資料

{ "status_code": 0, "message": "", "data": { "cart_id": "1,2,3", "address": { "id": "1", "real_name": "姓名", "phone": "手機號", "province": "廣東省", "city": "廣州市", "district": "海珠區", "detail": "詳細地址" }, "product_info": [{ "product_name": "商品名字", "num": "3", "price": "12.00", "sku": " 小米 紅色 ", "pic": "圖片地址" }], "postage": { "is_need": "是否需要郵費 1  需要 2 不需要  3 到付", "postage_price": "郵費價格" }, "coupon": [{ "can_use": "1 可以", "type": "1 是折扣 2是抵錢", "num": "數量", "use_time": "有效期", "name": "名字", "id": "優惠券id", "real": "真實的折扣或者錢數", "content": "介紹  如 最多抵扣錢", "max_price": "最多可抵扣錢數" }] } }

使用者地址 獲取

  請求地址

/user/addresslist

  請求方式

get

- 請求引數

無

  響應資料

{ status_code: 0, message: "", data: [ [{ id: 1, uid: 1, real_name: "張三", phone: "手機號", province: "廣東省", city: "廣州市", district: "海珠區", detail: "詳細地址", post_code: 100000, is_default: 0 // 是否預設地址 }] ] }

使用者地址 設定預設

  請求地址

/user/addressdefult

  請求方式

post

- 請求引數

address_id

  響應資料

{ status_code: 0, message: "", data:  }

使用者地址刪除

  請求地址

/user/addressdel

  請求方式

post

- 請求引數

address_id

  響應資料

{ status_code: 0, message: "", data:  }

使用者地址新增

  請求地址

/user/addressadd

  請求方式

post

- 請求引數

province 省 city 市 district 區 is_default 是否預設 1 為預設 其他為不是

real_name 真實姓名

post_code 郵編 非必須

phone 手機號

detail 詳細地址 id 如果 id 為 0 是新增 然後又值 是修改

  響應資料

{ status_code: 0, message: "", data:  }

討論區 列表

  請求方式

get

  請求地址

task/list

  請求方式

get

- 請求引數

page 頁碼 預設為 1

fid 分類 id 預設為 1

  響應資料

{ status_code: 0, message: "", data: { class: [{ id: 1, name: "分享推廣", count: 120 }, { id: 1, name: "諮詢", count: 120 } ], list: [{ id: 1, ask: "問題", answer: "回答", reply_count: "回覆數", update_at: "更新時間" }], total_page: "總頁數" } }

問題詳情頁

  請求方式

get

  請求地址

task/info

  請求引數

task_id

  響應資料

{ status_code: 0, message: "", data: { ask: { title: "提問內容 ", add_time: "提問時間" }, answer: [{ can_reply: "是否可以回答 1 可以 2 不可以", can_del: "是否可以刪除 1可以 2不可以", head_pic: "頭像地址", name: "姓名", content: "內容", time: "時間" }] } }

使用者刪除問題詳情頁評論

  請求地址

/task/del

  請求方式

post

- 請求引數

task_id

  響應資料

{ status_code: 0, message: "", data:  }

使用者新增問題詳情頁評論

  請求地址

/task/add

  請求方式

post

- 請求引數

task_id 問題 id

content 內容

  響應資料

{ status_code: 0, message: "", data:  }

使用者提交訂單

  請求方式

post

  請求地址

order/commit

  請求方式

get

- 請求引數

address_id 地址 id

cart_id 購物車 id coupon [['id'=>' 數量 ']]

message ‘ 留言 ’

  響應資料

{ status_code: 0, message: "", data:  提交給微信 那幾個欄位 }

我的

  請求地址

/center/index

  請求方式

post

- 請求引數

無

  響應資料

{ "status_code": 0, "message": "", "data": { "user": { "name": "", "head_pic": "頭像地址" }, "order": { "wait_pay": "代付款", "wait_take_over": "帶收貨", "wait_comment": "待評價", "wait_after_sale": "帶售後" } } }

我的訊息

  請求地址

/center/index

  請求方式

post

- 請求引數

page 頁碼

  響應資料

{ "status_code": 0, "message": "", "data": { "total_page": "總頁數", "list": [{ "head_url": "頭像地址", "name": "名字", "time": "時間", "content": "內容" }, { "head_url": "頭像地址", "name": "名字", "time": "時間", "content": "內容" }] } }

全部訂單

  請求地址

/order/orderlist

  請求方式

post

- 請求引數

page 頁碼

type ' 狀態 可不傳 -3 待支付 ； 1 ：待收貨； 2 ：已收貨； 3 ：待評價； '

  響應資料

{ "status_code": 0, "message": "", "data": [{ "order_id": "訂單號", "order_status": "-3 待支付   -1 : 申請退款 -2 : 退貨成功 0：待發貨；1：待收貨；2：已收貨；3：待評價；-1：已退款", "sum_price": "總價", "postage": { "is_need": "是否需要郵費 1  需要 2 不需要  3 到付", "postage_price": "郵費價格" }, "goods_info": { "goods_name": "商品名字", "pic": "圖片地址", "price": "價格", "id": "商品id", "sku": "商品屬性", "num": "商品名字" } }] }

使用者提交訂單 點選去支付按鈕

  請求方式

post

  請求地址

order/commitfromwaitpay

  請求方式

post

- 請求引數

order_id 訂單 id

  響應資料

{ status_code: 0, message: "", data:  提交給微信 那幾個欄位 }

訂單詳情頁

  請求方式

post

  請求地址

order/showinfo

  請求方式

post

- 請求引數

order_id 訂單 id

  響應資料

上傳圖片

  請求方式

post

  請求地址

common/uploadpic

  請求方式

post

- 請求引數

pic 圖片 key

  響應資料

{ status_code: 0, message: "", data:  picurl  圖片地址 }

評論訂單

  請求方式

post

  請求地址

order/comment

  請求方式

post

- 請求引數

pic 圖片 ['1.jpg','2.jpg']

content 評論內容 quality 數字 1-5 serveice_quality 數字 1-5

  響應資料

{"status_code":0,"message":"","data":[

優惠券列表

  請求方式

get

  請求地址

coupon/list

  請求方式

get

- 請求引數

type 1 未使用 2 已經使用 3 已經過期

  響應資料

{"status_code":0,"message":"","data": [{ "can_use": "1 可以", "type": "1 是折扣 2是抵錢", "num": "數量", "use_time": "有效期", "name": "名字", "id": "優惠券id", "real": "真實的折扣或者錢數", "content": "介紹  如 最多抵扣錢", "max_price": "最多可抵扣錢數" }]}

地址管理 請求上面的地址的資料就可以了

推廣資訊

  請求方式

get

  請求地址

extension/info

  請求方式

get

- 請求引數

  響應資料

{ "status_code": 0, "message": "", "data": { "sum_price": "累計佣金數", "already_refund": "已返卷", "wait_refund": "帶返卷" } }

推廣列表

  請求方式

get

  請求地址

extension/info

  請求方式

get

- 請求引數

  響應資料

{ "status_code": 0, "message": "", "data": { "fans_num": "粉絲數量", "list": [{ "head_pic": "頭像地址", "name": "名字", "register_time": "註冊時間", "price": "消費金額" }] } }

使用者收藏

  請求方式

get

  請求地址

user/collection

  請求方式

get

- 請求引數

  響應資料

{ "status_code": 0, "message": "", "data": { "sum": "2", "list": [{ "name": "名字", "pic_url": "圖片地址", "sale_num": "銷量", "price": "價格", "0": "id" }] } }

刪除訂單

  請求方式

post

  請求地址

order/delorder

  請求方式

post

- 請求引數

order_id 訂單 id

  響應資料

{"status_code":0,"message":"","data":[]}