鄰舍民宿接口文檔

接口文檔

狀態(tài)碼

-1 連接錯誤

0 成功

1 異常

4 登陸超時

1. 首頁

1.1 接口: /home ? GET

返回
  code: 0,
  data: {
    // 輪播圖
    "banners": [
        "http://localhost:3000/shanghai.jpg"
    ],
    // 熱門城市
    "hotCitys": [
        {
          "name": "上海",
          "code": "1", // 城市編碼
          "url": "http://localhost:3000/images/home/shanghai.jpg" // 城市圖片
        },
        {
          "name": "北京",
          "code": "2",
          "url": "http://localhost:3000/images/home/beijing.png"
        }
    ]
  }

1.2 獲取城市列表

接口: /getCityList ? GET

  參數(shù)
    pageSize: Number // must
    pageNo: Number // must

1.3

2.資源類接口

2.1 獲取熱門城市

接口:/resource/hotCity ? GET

  {
    "code": 0,
    "data": [
        {
          "name": "上海",
          "code": "1" // 城市編碼
        },
        {
          "name": "北京",
          "code": "2"
        }
    ]
}

2.2 搜索目的地

接口:/resource/search ? POST

  參數(shù)
    name: String, // must
返回
  code: 0,
  data: [
    {
      // 地點名稱
      name: '',
      // 地點編碼
      code: ''
    }
  ]

2.3 獲取房源列表

接口:/resource/list ? POST

  參數(shù)
    code: String, // 地區(qū)編碼 Option
    beginTime: 時間戳, // 入住時間 Option
    endTime: 時間戳, // 退房時間 Option
    minPrice: Number, // 最低價格 Option
    maxPrice: Number, // 最高價格 Option
    peoples: Number, // 入住人數(shù) Option
    lease: Number, // 租賃方式 Option
    bedType: Number, // 房間床型 Option
    houseType: Number, // 戶型 Option
    toilet: Number, // 衛(wèi)生間 Option
    pageNo: Number, // 頁碼 must
    pageSize: Number, // 頁數(shù) must
    sort: String, // 排序 must 0 默認排序(評分最高) 1 價格從高到底  2 價格從低到高 3 評分最高 
返回
  code: 0,
  data: [
    {
      houseId: '', // 房源Id
      name: '', // 房屋名稱
      images: [], // 圖片
      price: 0, // 價格
      lease: 1, // 整租|單間
      bedType: 1, // 單人床|雙人床|其他
      houseType: 1, // 一室|二室|三室|四室以上
      buildType: 1, // 公寓|民居|客棧
      toilet: 0, // 獨立|公共
      peoples: 2, // 宜居人數(shù)
      score: '5.0', // 評價
      evaluate: '15', // 評論數(shù)
      province: '', // 省份
      city: '', // 城市
      region: '', // 地區(qū)
      beginTime: 時間戳, 入住時間
      endTime: 時間戳, 退房時間
    }
  ]

2.4 獲取房屋詳情

接口:/resource/houseDetail ? GET

  參數(shù)
    houseId: String, // 房源Id must
返回
  code: 0,
  data: {
    // 房屋照片
    banners: [],
    users: {
      // 房主姓名
      name: '',
      // 房主頭像
      avatarUrl: ``,
      // 房主電話
      phone: ''
    },
    houses: {
      // 面積
      area: 70,
      // 租賃類型
      lease: '整租',
      // 房屋類型
      buildType: '民居',
      // 房屋格局
      houseType: '2室1廳',
      // 居住人數(shù)
      peoples: '4',
      // 廁所
      toilet: '1',
      // 床位
      bed: '1',
      // 房屋描述
      describe: '',
      // 評價
      scores: null,
      // 地址
      addr: '上海浦東新區(qū)',
      // 坐標
      coordinate: ['110', '45']
    },
    configure: {
      net: '無線WIFI',
      tv: '電視',
      shower: '淋浴',
      air: '空調',
      heating: '暖氣',
      washer: '洗衣機',
      freezer: '電冰箱',
      hotWater: '全天熱水',
      kitchen: '廚房',
      towel: '毛巾',
      slipper: '拖鞋',
      once: '一次性用品',
      kettle: '熱水壺',
      elevator: '電梯',
      tableware: '餐具炊具',
      blower: '吹風機',
      smartLock: '智能門鎖',
      cook: '允許做飯'
    },
    notes: {
      // 最早入住時間
      checkInTime: '',
      // 最晚退房時間
      checkOutTime: '',
      // 最少入住天數(shù)
      daysToStay: '',
      // 房間編號
      houseNum: '',
      // 身份證
      idCard: '',
      // 線下押金
      deposit: '',
      // 房東要求
      landlordReq: '',
      // 入住須知
      notice: '',
      // 允許聚餐
      allowDinner: '',
      // 水電費
      waterAndEl: '',
      // 額外加床
      extraBed: '',
      // 機場/火車站接送
      relay: ''
    }
  }

2.5 獲取房屋評論

接口:/resource/evaluate ? GET

  參數(shù)
    houseId: String // 房源Id must

2.6 添加房屋評論

接口:/resource/addEvaluate ? POST

  參數(shù)
    houseId: String, // 房源Id must
    avatarUrl: String, // 用戶頭像 must
    name: String, // 用戶昵稱 must
    content: String, // 評論內容 must
    score: Number // 評分(最高5分) must

3.賬戶類接口

3.1 小程序登陸

接口: /account/wxlogin ? POST

  參數(shù)
    phone: String, // 手機號 must
    password: String, // 密碼 must (MD5加密規(guī)則 -> 手機號 加上 密碼的加密犬耻,然后整個加密)
    name: String, // 昵稱 must
    code: String, // 微信code must
    avatarUrl: String, // 用戶頭像 must
  返回
  code: 0,
  data: {
    userId: '', // 用戶id
  },
  msg: '登錄成功'

3.2 后臺登陸

接口: /account/login ? POST

  參數(shù)
    phone: String, // 手機號 must
    password: String, // 密碼 must (MD5加密規(guī)則 -> 手機號 加上 密碼的加密惶傻,然后整個加密)

3.3 修改用戶信息

接口: /account/modify ? POST

  參數(shù)
    phone: String, // 手機號 must
    oldPassword: String, // 舊密碼 must
    password: String, // 新密碼 must
    userId: String, // 用戶Id must

4.文章類接口

4.1 獲取文章列表

接口: /discover/wonderful ? GET

  參數(shù)
    pageNo: Number, // 頁碼 must
    pageSize: Number, // 頁數(shù) must

4.2 查看文章詳情

接口: /discover/articleDetail ? GET

  參數(shù)
    id: String // 文章id must

4.3 添加文章

接口: /discover/addWonderful ? POST

  參數(shù)
    title: String // 文章標題
    content: String // 文章內容

4.4 上傳文章封面 TODO

接口: /discover/uploadBanner ? POST

  參數(shù)

5.訂單類接口

5.1 生成訂單

接口:/order/generateOrder ? POST

  參數(shù)
    houseId: String, // 房源Id must
    userId: String, // 用戶Id must
    beginTime: Number, // 入住日期 must
    endTime: Number, // 離開日期 must
    name: String, // 房客姓名 option
    phone: String, // 手機號 must
    totalPrice: Number, // 總價 must

5.2 訂單確認支付

接口:/order/confirmPayment ? POST

  參數(shù)
    orderId: String, // 訂單號 must
    totalPrice: Number, // 總價 must

5.3 訂單列表

接口:/order/getOrderList ? POST

  參數(shù)
    status: Number, // 狀態(tài) 0 進行中 1 已結果 must
    userId: String, // 用戶Id must
    pageSize: Number, // 頁數(shù) must
    pageNo: Number, // 頁碼
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市秘车,隨后出現(xiàn)的幾起案子分冈,更是在濱河造成了極大的恐慌部凑,老刑警劉巖蘸吓,帶你破解...
    沈念sama閱讀 221,198評論 6 514
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異勒叠,居然都是意外死亡兜挨,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,334評論 3 398
  • 文/潘曉璐 我一進店門缴饭,熙熙樓的掌柜王于貴愁眉苦臉地迎上來暑劝,“玉大人,你說我怎么就攤上這事颗搂〉C停” “怎么了?”我有些...
    開封第一講書人閱讀 167,643評論 0 360
  • 文/不壞的土叔 我叫張陵丢氢,是天一觀的道長傅联。 經常有香客問我,道長疚察,這世上最難降的妖魔是什么蒸走? 我笑而不...
    開封第一講書人閱讀 59,495評論 1 296
  • 正文 為了忘掉前任,我火速辦了婚禮貌嫡,結果婚禮上比驻,老公的妹妹穿的比我還像新娘。我一直安慰自己岛抄,他們只是感情好别惦,可當我...
    茶點故事閱讀 68,502評論 6 397
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著夫椭,像睡著了一般掸掸。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上蹭秋,一...
    開封第一講書人閱讀 52,156評論 1 308
  • 那天扰付,我揣著相機與錄音,去河邊找鬼仁讨。 笑死羽莺,一個胖子當著我的面吹牛,可吹牛的內容都是我干的陪竿。 我是一名探鬼主播禽翼,決...
    沈念sama閱讀 40,743評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼族跛!你這毒婦竟也來了闰挡?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 39,659評論 0 276
  • 序言:老撾萬榮一對情侶失蹤礁哄,失蹤者是張志新(化名)和其女友劉穎长酗,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體桐绒,經...
    沈念sama閱讀 46,200評論 1 319
  • 正文 獨居荒郊野嶺守林人離奇死亡夺脾,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 38,282評論 3 340
  • 正文 我和宋清朗相戀三年之拨,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片咧叭。...
    茶點故事閱讀 40,424評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡蚀乔,死狀恐怖,靈堂內的尸體忽然破棺而出菲茬,到底是詐尸還是另有隱情吉挣,我是刑警寧澤,帶...
    沈念sama閱讀 36,107評論 5 349
  • 正文 年R本政府宣布婉弹,位于F島的核電站睬魂,受9級特大地震影響,放射性物質發(fā)生泄漏镀赌。R本人自食惡果不足惜氯哮,卻給世界環(huán)境...
    茶點故事閱讀 41,789評論 3 333
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望商佛。 院中可真熱鬧喉钢,春花似錦、人聲如沸良姆。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,264評論 0 23
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽歇盼。三九已至,卻和暖如春评抚,著一層夾襖步出監(jiān)牢的瞬間豹缀,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,390評論 1 271
  • 我被黑心中介騙來泰國打工慨代, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留邢笙,地道東北人。 一個月前我還...
    沈念sama閱讀 48,798評論 3 376
  • 正文 我出身青樓侍匙,卻偏偏與公主長得像氮惯,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子想暗,可洞房花燭夜當晚...
    茶點故事閱讀 45,435評論 2 359

推薦閱讀更多精彩內容

  • Swift1> Swift和OC的區(qū)別1.1> Swift沒有地址/指針的概念1.2> 泛型1.3> 類型嚴謹 對...
    cosWriter閱讀 11,109評論 1 32
  • 【必讀】 接口地址 內網環(huán)境:172.17.8.100 外網環(huán)境:mobile.bwstudent.com 開發(fā)人...
    王帥Alex閱讀 20,031評論 11 45
  • feisky云計算妇汗、虛擬化與Linux技術筆記posts - 1014, comments - 298, trac...
    不排版閱讀 3,866評論 0 5
  • 參考https://www.kancloud.cn/liupeizhi/openapi/292276https:/...
    Helen_Cat閱讀 13,310評論 0 17
  • 這半年來,咳嗽時不時發(fā)作说莫,沒有任何征兆的杨箭,也沒有其他癥狀,所以自己也不知所以然储狭。今天早上互婿,又是一陣咳嗽使我從夢中醒...
    蘭瑾張閱讀 246評論 0 0