接口文檔
1、用戶登錄-- post /user/login/
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
username | 字符串 | 是 | 消息體 | 用戶名 |
password | 字符串 | 是 | 消息體 | 用戶名 |
響應信息 登陸成功: {
"code":200,
"message":"登陸成功",
"token":"123456789" ? }
登錄失?。? {
"code":403,
"message":"登陸失敗", ? }
2.用戶注冊 --post /user/register
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
user_name | 字符串 | 是 | 消息體 | 用戶名 |
pass_word | 字符串 | 是 | 消息體 | 用戶名 |
user_tel | 字符串 | 是 | 消息體 | 電話 |
user_full_name | 字符串 | 是 | 消息體 | 用戶真實姓名 |
user_sex | 字符串 | 是 | 消息體 | 用戶性別 |
user_birth | 字符串 | 是 | 消息體 | 用戶出生 |
user_email | 字符串 | 是 | 消息體 | 用戶郵箱 |
user_photo | 字符串 | 是 | 消息體 | 用戶頭像 |
響應信息 注冊成功 狀態碼:200 { "user_name": "張三",
"user_tel": "13697552828",
"user_full_name": "李四",
"user_sex": 男,
"user_birth": "2000/1/1",
"user_email": "123456789@qq.com",
"user_photo": "" ? } 注冊失敗 狀態碼:403 ? {
"detail":"注冊信息有誤"
}
3.添加文章 post /article/add_article
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
article_title | 字符串 | 是 | 消息體 | 文章主題 |
article_content | 字符串 | 是 | 消息體 | 文章內容 |
article_put_time | 字符串 | 是 | 消息體 | 發布時間 |
article_pic | 字符串 | 是 | 消息體 | 圖片 |
article_day | 字符串 | 是 | 消息體 | 旅游天數 |
article_per_cost | 字符串 | 是 | 消息體 | 花費 |
article_go_time | 字符串 | 否 | 消息體 | 出發時間 |
響應內容 成功狀態碼:200 { "article_title": "游記標題",
"article_content": "游記內容",
"article_put_time": "發布時間",
"article_pic": "圖片",
"article_put_time": "發布時間",
"article_day": "出行天數",
"article_per_cost": "花費",
"article_go_time": "出發時間"
} 失敗狀態碼:403 ? {
"detail":"未提供身份認證信息"
} 失敗狀態碼:404 ? {
"detail":"當前用戶沒有操作權限 "
} 4.更新文章 -- PUT updata_article
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
article_title | 字符串 | 是 | 消息體 | 文章主題 |
article_content | 字符串 | 是 | 消息體 | 文章內容 |
article_put_time | 字符串 | 否 | 消息體 | 發布時間 |
article_pic | 字符串 | 否 | 消息體 | 圖片 |
article_day | 字符串 | 否 | 消息體 | 旅游天數 |
article_per_cost | 字符串 | 是 | 消息體 | 花費 |
article_go_time | 字符串 | 是 | 消息體 | 出發時間 |
article_good_count | 字符串 | 是 | 消息體 | 好評 |
article_bad_count | 字符串 | 是 | 消息體 | 差評 |
成功狀態碼:200 {
"article_id":""
"user_id":[{
"user_name":"用戶名字",
}],
"location_id":[{
"location_name":"地區名字",
}],
"article_title": "文章主題",
"article_content": "文章攻略內容",
"article_pic": "圖片",
"article_put_time": "出發時間",
"article_day": "旅游天數",
"article_go_time": "出發時間",
"article__good_count": "好評數",
"article_bad_count": "差評數",
"article_per_cost": "花費"
}
失敗狀態碼:403
{
"detail":"未提供身份認證信息"
}
失敗狀態碼:404 {
"detail":"當前用戶沒有操作權限 "
} 5.刪除文章--DELETE /article/del_article
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
成功狀態碼:200 {
"message":"刪除成功"
} 失敗狀態碼:403 ? {
"detail":"未提供身份認證信息"
} 失敗狀態碼:404 ? {
"detail":"當前用戶沒有操作權限 "
} 6.查詢文章--GET /article/get_article
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
article_title | 字符串 | 是 | 查詢參數 | 文章主題 |
article_content | 字符串 | 是 | 查詢參數 | 文章內容 |
page | 整數 | 否 | 查詢參數 | 頁碼 |
size | 整數 | 否 | 查詢參數 | 頁面大小 |
成功狀態碼:200 {
"next":"上一頁",
"previous":"下一頁",
"result"[{
"article_id":""
"user_id":[{
"user_name":"用戶名字",
}],
"location_id":[{
"location_name":"地區名字",
}],
"article_title": "文章主題",
"article_content": "文章攻略內容",
"article_pic": "圖片",
"article_put_time": "出發時間",
"article_day": "旅游天數",
"article_go_time": "出發時間",
"article__good_count": "好評數",
"article_bad_count": "差評數",
"article_per_cost": "花費"
}] ? } 7.查詢地區--GET /common/location/ 請求參數:無 響應信息 ? { ? "location_id":"",
"country_id":[
"country_name":"國家",
]
"location_name": "地區名字",
"location_info": "地區介紹",
"location_pic": "地區圖片",
"location_room": "周邊住宿",
"location_eat": "周邊飯店"
} 8.景點查詢--GET /common/sights/ 請求參數:無 響應信息 ? {
"sight_id":"",
"location_id":[{
"location_name":"景區地區"
}]
"varible_id":[{
"varible_name":"類型"
}]
"sight_name": "景區名字",
"sight_pic":"圖片",
"sight_food": "景區美食",
"sight_ticket": "門票",
"sight_info": "景區介紹"
} 9.添加私人訂制--POST /vip/add_vip/
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
vip_go_date | 字符串 | 否 | 消息體 | 訂制出發時間 |
vip_back_date | 字符串 | 否 | 消息體 | 訂制返回時間 |
vip_pop | 字符串 | 否 | 消息體 | 訂制旅游人數 |
vip_info | 字符串 | 否 | 消息體 | 訂制信息描述 |
vip_tel | 字符串 | 否 | 消息體 | 用戶電話 |
vip_real_name | 字符串 | 否 | 消息體 | 用戶真實姓名 |
varible_id | 字符串 | 否 | 消息體 | 出游類型 |
service_id | 字符串 | 否 | 消息體 | 服務類型 |
hotel_id | 字符串 | 否 | 消息體 | 酒店類型 |
響應信息 成功狀態碼:200 { "vip_id":"",
"vip_go_date": "出發時間",
"vip_back_date": "返回時間",
"vip_pop": "人數",
"vip_info": "訂制信息",
"vip_tel": "用戶電話",
"vip_real_name": "真實姓名",
"varible_id": [
{
"varible_name": "出游類型名稱"
}
],
"service_id": [
{
"service_type": "服務類型",
"service_info": "服務描述"
} ? ], ? "hotel_id": [ ? { ? "hotel_type": "酒店類型" ? } ? ], ? } 失敗狀態碼:403 ? { ? "detail":"未提供身份認證信息" ? } 失敗狀態碼:404 ? { ? "detail":"當前用戶沒有操作權限 " ? } 10.刪除私人訂制--DELETE /vip/del_vip/
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
響應信息 成功狀態碼:200 { "message":"刪除成功" } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 11.修改私人訂制--PUT /vip/updata_vip
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
vip_go_date | 字符串 | 否 | 消息體 | 訂制出發時間 |
vip_back_date | 字符串 | 否 | 消息體 | 訂制返回時間 |
vip_pop | 字符串 | 否 | 消息體 | 訂制旅游人數 |
vip_info | 字符串 | 否 | 消息體 | 訂制信息描述 |
vip_tel | 字符串 | 否 | 消息體 | 用戶電話 |
vip_real_name | 字符串 | 否 | 消息體 | 用戶真實姓名 |
varible_id | 字符串 | 否 | 消息體 | 出游類型 |
service_id | 字符串 | 否 | 消息體 | 服務類型 |
hotel_id | 字符串 | 否 | 消息體 | 酒店類型 |
響應信息 成功狀態碼:200 { "vip_id":"", "vip_go_data": "出發時間", "vip_back_data": "返回時間", "vip_pop": "人數", "vip_info": "訂制信息", "vip_tel": "用戶電話", "vip_real_name": "真實姓名", "varible_id": [ { "varible_name": "出游類型名稱" } ], "service_id": [ { "service_type": "服務類型", "service_info": "服務描述" } ], "hotel_id": [ { "hotel_type": "酒店類型" } ], } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 12.查看私人訂制--PUT /vip/get_vip
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
vip_real_name | 字符串 | 是 | 查詢參數 | 文章主題 |
vip_tel | 字符串 | 是 | 查詢參數 | 文章內容 |
page | 整數 | 否 | 查詢參數 | 頁碼 |
size | 整數 | 否 | 查詢參數 | 頁面大小 |
響應信息 { "next":"上一頁", "previous":"下一頁", "reault"[{ "vip_id":"", "vip_go_data": "出發時間", "vip_back_data": "返回時間", "vip_pop": "人數", "vip_info": "訂制信息", "vip_tel": "用戶電話", "vip_real_name": "真實姓名", "varible_id": [ { "varible_name": "出游類型名稱" } ], "service_id": [ { "service_type": "服務類型", "service_info": "服務描述" } ], "hotel_id": [ { "hotel_type": "酒店類型" } ], }] } 13.服務類型--GET /vip/service/ 請求參數:無 響應信息 { "service_ic":"", "service_type": "服務類型", "service_pic": "圖片", "service_info": "服務介紹" } 14.查詢酒店--GET /vip/hotel/ 請求參數:無 響應信息 { "hotel_id":"", "hotel_type": "酒店類型", "hotel_pic": "圖片", "hotel_info": "酒店介紹" } 15.國家安全--GET /vip/countries/ 請求參數:無 響應信息 { "country_id":"", "country_name": "國家名字", "country_issafe": "是否安全" } 16.添加組隊信息--POST /team/add_team
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
team_title | 字符串 | 否 | 消息體 | 組隊標題 |
team_tel | 字符串 | 否 | 消息體 | 聯系電話 |
team_sex | 字符串 | 否 | 消息體 | 性別要求 |
team_pop | 字符串 | 否 | 消息體 | 組隊人數 |
team_info | 字符串 | 否 | 消息體 | 組隊簡介 |
team_put_date | 字符串 | 否 | 消息體 | 發起組隊消息時間 |
team_out_data | 字符串 | 否 | 消息體 | 組隊消息失效時間 |
響應信息 成功狀態碼:200 { "team_id":"", "team_title": "西藏游", "team_tel": "13012345678", "team_sex": "性別不限", "team_pop": "5人", "team_put_date": "2000/5/5", "team_info": "自駕游,先到先得", "team_out_data": "2000/5/10" } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 17.修改組隊信息--PUT /team/updata_team
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
team_title | 字符串 | 否 | 消息體 | 組隊標題 |
team_tel | 字符串 | 否 | 消息體 | 聯系電話 |
team_sex | 字符串 | 否 | 消息體 | 性別要求 |
team_pop | 字符串 | 否 | 消息體 | 組隊人數 |
team_info | 字符串 | 否 | 消息體 | 組隊簡介 |
team_put_date | 字符串 | 否 | 消息體 | 發起組隊消息時間 |
team_out_data | 字符串 | 否 | 消息體 | 組隊消息失效時間 |
響應信息 成功狀態碼:200 { "team_id":"", "team_title": "西藏游", "team_tel": "13012345678", "team_sex": "性別不限", "team_pop": "5人", "team_put_date": "2000/5/5", "team_info": "自駕游,先到先得", "team_out_data": "2000/5/10" } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 18.刪除組隊信息--DELETE /team/del_team
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
響應信息 成功狀態碼:200 { "message":"刪除成功" } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 19.查看組隊信息--GET /team/get_team
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
team_title | 字符串 | 否 | 查詢參數 | 組隊主題 |
team_info | 字符串 | 否 | 查詢參數 | 組隊簡介 |
page | 整數 | 否 | 查詢參數 | 頁碼 |
size | 整數 | 否 | 查詢參數 | 頁面大小 |
響應信息 { "next":"上一頁", "previous":"下一頁", "result":[{ "team_id":"", "team_title": "西藏游", "team_tel": "13012345678", "team_sex": "性別不限", "team_pop": "5人", "team_put_date": "2000/5/5", "team_info": "自駕游,先到先得", "team_out_data": "2000/5/10" }] } 20.舉報原因--POST /common/report_reason/
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
reason_typ | 字符串 | 是 | 消息體 | 舉報類型 |
響應信息 成功狀態碼:200 { "reason_id":"", "reason_type": "舉報類型" } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 21.--出游類型--POST /common/variable/
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
響應信息 成功狀態碼:200 { "variable_id":"", "variable_name": "海邊" } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 22.舉報組隊--POST /common/team_report/
請求參數 | 類型 | 是否必填 | 參數位置 | 說明 |
---|---|---|---|---|
token | 字符串 | 是 | 請求頭 | 用戶身份認證 |
reason_id | 字符串 | 是 | 消息體 | 舉報原因 |
team_id | 字符串 | 是 | 消息體 | 舉報隊伍 |
響應信息 成功狀態碼:200 { "team_report_id":"", "reason_id": [ { "reason_type": "廣告" } ], "team_id": 1, "team_report_info": "廣告文,無實用" } 失敗狀態碼:403 { "detail":"未提供身份認證信息" } 失敗狀態碼:404 { "detail":"當前用戶沒有操作權限 " } 23.黑名單--GET /common/black_type/ 請求參數:無 響應信息 { "black_type": "禁言7天" }