api的采用 jwt 鑒權(quán)方式掉盅,登錄成功后后臺返回 token朝扼,后面的請求一律帶上 Authorization 頭
短信驗證碼登錄
- 獲取驗證碼: POST /api/sms/code
{"username":"13812345678"} - 登錄:POST /api/users/login2
{"username":"13812345678",
"code":"7986"}
用戶管理 User
- 注冊新用戶
POST /api/users/
{
"username": "18612345678",
"nickname": "黃小姐"
}
- 更新用戶信息
PUT /api/users/:userId
{
"username": "18612345678",
"profile": {
"name": "黃先生"
}
}
車型庫 Auto
GET /api/autos/brands 獲得品牌款型數(shù)據(jù)
GET /api/autos/models?brand=奧迪&&series=A6 獲取車型年款信息赃阀,這里每個車型都有_id
用戶車輛 Userauto:
- 添加新車,username和autoId是必須的擎颖。api返回包含userautoId的新車的完整信息
POST /api/userautos
{
"username" : "13587451247",
"autoId" : "sdgwexccvsda214x", //從/api/autos/models獲取的車型記錄的_id
"licence" : "滬CZ1039"
}
- 獲取當前登錄用戶的所有車輛
GET /api/userautos
- 更新車輛信息榛斯,可以更新字段如下:
username: String, // 用戶名 (手機號)
licence: String, // 車牌號
autoId: String // 車型的_id
PUT /api/userautos/:userauto_Id
- 設(shè)置車輛為默認車輛:
PUT /api/userautos/:userauto_Id
{
"current" : "1"
}
- 刪除用戶的車
DELETE /api/userautos/:userauto_id
項目 Item
- 獲取項目及其工時費,參數(shù)是當前車輛userautoId搂捧,公里數(shù)mileage
GET /api/items/recommend?userautoId=xxxxxxx&mileage=50000
返回一個包含所有項目信息對象的數(shù)組驮俗,項目對象如下:
{
'id': 'oil', // 項目的id
'item': '機油', // 項目的名稱
‘type’: by, // 項目的類別(保養(yǎng)by,維修wx允跑,鈑噴bp王凑,美容mr)
'cate': 'engine', //項目的子類別
'period': 5000, // 多少公里需要做此項目
'manhour' : 40, //工時費
‘recommend’ : 1, // 是否推薦,1表示推薦聋丝,0不推薦
’amount' : 4.5 // 需要的數(shù)量
}
訂單 Order
- (下單用接口)獲取下單車輛的所有項目的配件索烹,參數(shù)userautoId是下單車輛的_id
GET /api/parts/match?userautoId=xxxxxxx
- 創(chuàng)建訂單
POST /api/orders
{
"mileage" : 74000,
"worker" : "HEfCLj4sNsXussA3b",
"reserveTime" : "2016-01-27 10:00:00",
"userautoId" : "dsXmgLJppEQCSCoy9", // 下單車輛 userauto 的 _id
"message" : "",
"charge": 260,
"details" : [ {
"partId" : "ZT46M8M9jGYQ6ENan", // 配件的 _id
"partBrand" : "殼牌",
"partModel" : "黃喜力HX5 SN級 10W-40 ",
"unitPrice" : 34,
"amt" : 4,
"manhour" : 40,
"item" : "oil"
}]
}
- 刪除訂單
DELETE /api/orders/:order_id - 更新訂單,字段都是可選
POST /api/orders/:order_id
{
"mileage" : 74000,
"reserveTime" : "2016-01-27 10:00:00",
"message" : "",
"status" : 3,
"charge": 260,
"details" : [ {
"partId" : "ZT46M8M9jGYQ6ENan", // 配件的 _id
"partBrand" : "殼牌",
"partModel" : "黃喜力HX5 SN級 10W-40 ",
"unitPrice" : 34,
"amt" : 4,
"manhour" : 40,
"item" : "oil"
}]
}
施工單位 Worker
- 獲取列表
GET /api/factory/workers