悠悠校園后臺api

域名和端口

http://52.24.88.186:8888/

請求格式

對于POST和PUT請求,請求的主體必須是JSON格式,

錯誤返回

正確返回在詳細中,所有出錯返回均為

{
    'state':'error',
    'error':' error detail'
}

詳細使用

用戶認證

  • url: /1.0/auth

  • methed:post

  • 發送參數

    {
        type:'',
        phone_num:'',
        password:'',
    }
    
    
  • 返回

    {
        state:' ', //ok or error
        [error]:'',//when error
    
        [uid]:,// when ok
        [token]:'',
    
    }
    

用戶取消認證

本操作將刪除設備令牌token

  • url:/v1.0/auth/{{uid}}/{{token}}

  • methed:delete

  • 返回

    {
        state:'', //ok or error
        [error]:'', //error info when error
    }
    

獲取用戶信息

  • url/v1.0/users/{{uid}}

  • methed get

  • 返回

    {
        uid: ,
        sex: , // 0 for female, 1 for male
        username:'',
        phone_num:' ',
        score: ,
        qq:'',
        school:'',
        dept:'',
        sign,' ',
        enroll_year:'',//入學時間
        home_area:' ',
        home_city:'',
        home_province:' ',
        birthday:' ',
        constellation:' ',
        hobbies: ' ',
        image: ' '
    }
    

注冊

  • url`/v1.0/users

  • methed post

  • 參數

    {
        username = '',
        image ='',
        sex = 1 or 0,
        phone_num = ' ',
        school = ' ',
        dept = ' ',
        enroll_year = ' ',入學時間
    password = ' '//hash過
    }
    
  • 返回

    {
        uid: ,
        token:'',
    }
    

修改用戶信息

  • url/v1.0/users

  • methed :put

  • 參數

    {
        uid: ,
        token:'',
        sex: , // 0 for female, 1 for male
        username:'',
        phone_num:' ',
        score: ,
        qq:'',
        school:'',
        dept:'',
        sign,' ',
        enroll_year:'',//入學時間
        home_area:' ',
        home_city:'',
        home_province:' ',
        birthday:' ',
        constellation:' ',
        hobbies: ' ',
                image: ' ' ,
    }
    
  • 返回

    {
        uid: ,
        token:'',
    }
    

獲取用戶權限手機號是否公開,收藏是否公開

  • url: /v1.0/users/authority/{{uid}}/{{token}}/

  • methed:get

  • 返回

    {
        phone_pub:,
        coll_pub:
    }
    

修改用戶權限手機號是否公開,收藏是否公開

  • url: /v1.0/users/authority/{{uid}}/{{token}}

  • methed:put

  • 參數

    {
        phone_pub: ,
        coll_pub:
    }
    
  • 返回

    {
        state:'' ,
    }
    

查看簽到信息

  • url: /v1.0/sign/{{uid}}/{{token}}

  • methed:get

  • 返回

    {
        sign:true or false
    }
    

簽到

  • url: /v1.0/sign/{{uid}}/{{token}}

  • methed:post

  • 返回

    {
        state:'ok'
    }
    

搜索用戶

  • url:/v1.0/users/search

  • methed:post

  • 參數

        {
            'key_word':'',
            ['page']: ,
        }
    

獲取分類商品

  • url:/v1.0/goods

  • methed:get

  • 參數

    {
        kind:,//表示商品分類
        sort_by:'',//排序方式( 'multiple','date','view','price',)
        [reversed]: true or false ,//如果存在則倒序排序,否則正序
        page: ,//每次返回20個,表示第幾個20個
    }
    
  • 返回

    [
        {
            gid: ,
            name:'',
            views: ,
            price: ,
            date: '',
            image:'',
        },
        ...
    ]
    

獲取商品詳情

  • url:/v1.0/goods/{{gid}}

  • methed: get

  • 參數:
    none

  • 返回

    {
        gid: ,
        name: ' ',
        price: ,
        image:' ',
        user_info:{
            uid: ,
            username:' ',
            user_image: ' ',
            phone_num:' ',
            qq:' '
        }
        school:' ',
        old: ' ',
        date:' ',
        content: ' ', // 描述
        kind:{
            kind1_name:'',
            kind2_name:'',
        }
        views: ,
    
    }
    

獲取首頁最新商品

  • url:/v1.0/new_goods

  • methed get

  • 參數

    {
        [page]: ,//一次返回20個商品,默認為 1 ,
    }
    
  • 返回

    [
        {
            gid: ,
            name:'',
            price: ,
            date: '',
            school: '',
            image: ' ',
        },
        ...
    ]
    

搜索商品

  • url:/v1.0/goods/search

  • methed:post

  • 參數

    {
        key_word: ' ',
        [page]: ,
    }
    
  • 返回

    {
        gid: ,
        name: ,
        price: ,
        image: ,
        views: ,
        date: ' ',
    
    }
    

發布商品

  • url: /v1.0/goods

  • methed: post

  • 參數

    {
        uid:
        token:' ',
        name:'',
        image:'',
        school:'', //商品所屬學校校
        price: ,
        content:'', //描述
        kind: ,//分類信息
        old: '' // 新舊程度
    }
    
  • 返回

    {
        state:'',  //ok or error
    }
    

修改商品信息

  • url: /v1.0/goods

  • methed: put

  • 參數

    {
        uid:
        token:' ',
        name:'',
        image:'',
        school:'', //商品所屬學校校
        price: ,
        content:'', //描述
        kind: ,//分類信息
        old: '' // 新舊程度
    }
    
  • 返回

    {
        state:'',  //ok or error
        [error]:'' , //error info when error
    }
    

下架貨物

  • url: /v1.0/goods/{{uid}}/{{token}}/{{gid}}

  • methed: DELETE

  • 返回
    {
        state:'',  //ok or error
        [error]:'' , //error info when error
    }
    

重新上架貨物

* url: `/v1.0/goods/{{uid}}/{{token}}/{{gid}}`

* methed: `POST`

* 返回
    ```
    {
        state:'',  //ok or error
        [error]:'' , //error info when error
    }
    ```

獲取分類求購

  • url: /v1.0/wants

  • methed: get

  • 參數

    {
        kind: ,
        sort_by:'',//'multiple','date','view','price'
        reversed:' ',
        {{page}}:' '
    }
    
  • 返回

    {
        wid: ,
        name:'',
        price: ,
        image: ,
        views: ,
        date: ,
        user_info:{
            uid: ,
            username: ,
            image:
        }
    }
    

獲取求購詳情

  • url: /v1.0/wants/{{wid}}

  • methed: get

  • 返回
    {
        wid: ,
        name:' ',
        views: ,
        price: ,
        content: ' ',
        school:' ',
        user_info:{
            uid: ,
            username:' ',
            image:' '
        },
        kind_info:{
            kind_name:' '
        }
    
    }
    

獲取首頁最新求購信息

  • url: /v1.0/wants/index

  • methed: get

  • 參數

    {
        {{page}}
    }
    
  • 返回

    [
        {
            wid: ,
            name:' ' ,
            price: ,
            views: ,
            data:' ',
                        school:' ',
            user_info:{
                uid: ,
                username: ,
                image: ' '
            }
        },
        ....
    ]
    

搜索求購

  • url:/v1.0/wants/search

  • methed:post

  • 參數

    {
        key_word:' ',
        [page]:
    }
    

發布求購信息

  • url: /v1.0/wants/{{uid}}/{{token}}

  • methed: post

  • 參數

    {
        uid:
        token:' ',
        name:'',
        image:'',
        school:'', //商品所屬學校校
        price: ,
        content:'', //描述
        kind: ,//分類信息
        old: '' // 新舊程度
    }
    
  • 返回

    {
        state:'',  //ok or error
    
    }
    

修改求購信息

  • url: /v1.0/wants/{{uid}}/{{token}}

  • methed: put

  • 參數

    {
        uid:
        token:' ',
        name:'',
        image:'',
        school:'', //商品所屬學校校
        price: ,
        content:'', //描述
        kind: ,//分類信息
        old: '' // 新舊程度
    }
    
  • 返回

    {
        state:'',  //ok or error
    
    }
    

刪除求購信息

  • url: /v1.0/wants/{{uid}}/{{wid}}/{{token}}

  • methed: delete

  • 返回
    {
        state:'',  //ok or error
    }
    

獲取當前用戶收藏商品信息

  • url:/v1.0/collections/goods

  • methed:POST

  • 參數

    {
        uid:' ',
        token: ' ',
        [page]:' '
    }
    
  • 返回

    {
        'user_info':{
            uid:,
            username: '',
            image:' ',
        },
        price:' ',
        state:' ',//狀態 商品出售中或者已經下架
        gid: ' ',
        date: ' ',
        image:' ',
        name:' '
    }
    

獲取當前用戶收藏求購信息

* url:`/v1.0/collections/wants`

* methed:`POST`

* 參數

    ```
    {
        uid:' ',
        token: ' ',
        [page]:' '
    }
    ```

* 返回
    ```
    {
        'user_info':{
            uid:,
            username: '',
            image:' ',
        },
        price:' ',
        state:' ',//狀態 商品出售中或者已經下架
        wid: ' ',
        date: ' ',
        name:' '
    }
    ```

獲取制定用戶收藏商品信息

* url:`/v1.0/collections/goods/{{uid}}`

* methed:`GET`

* 參數

    ```
    {
        [page]:' '
    }
    ```

* 返回
    ```
    {
        'user_info':{
            uid:,
            username: '',
            image:' ',
        },
        price:' ',
        state:' ',//狀態 商品出售中或者已經下架
        gid: ' ',
        date: ' ',
        image:' ',
        name:' '
    }
    ```

獲取指定用戶收藏求購信息

* url:`/v1.0/collections/wants/{{uid}}`

* methed:`GET`

* 參數

    ```
    {
        [page]:' '
    }
    ```

* 返回
    ```
    {
        'user_info':{
            uid:,
            username: '',
            image:' ',
        },
        price:' ',
        state:' ',//狀態 商品出售中或者已經下架
        wid: ' ',
        date: ' ',
        name:' '
    }
    ```

新增商品收藏

  • url : /v1.0/collections/goods/{{uid}}/{{gid}}/{{token}}

  • methed: 'post',

  • 返回

    {
        state:' ok',
    }
    

新增求購收藏

  • url : /v1.0/collections/wants/{{uid}}/{{gid}}/{{token}}

  • methed: 'post',

  • 返回

    {
        state:' ok',
    }
    

刪除商品收藏

  • url : /v1.0/collections/goods/{{uid}}/{{gid}}/{{token}}

  • methed: 'DELETE',

  • 返回

    {
        state:' ok',
    }
    

刪除求購收藏

  • url : /v1.0/collections/wants/{{uid}}/{{gid}}/{{token}}

  • methed: 'DELETE',

  • 返回

    {
        state:' ok',
    }
    

獲取一級分類分類信息

  • url/v1.0/kinds

  • methed:get

  • 返回

        {
            kid: ,
            name:' ',
            image:' '
        }
    

獲取一級分類下所有二級分類信息

  • url/v1.0/kinds/{{ l_kid }}

  • methed:get

  • 返回

    {
        s_kid: ,
        name:'',
        image:'',
    }
    
    

獲取商品評論

  • url:/v1.0/comments/goods/{{gid}}

  • methed:get

  • 參數
    {
    [page]
    }

  • 返回

    {
        name: ' ',// 商品名
        comment:' ',
        to_user:{
            uid: ,
            username:' ',
            image:' '
        },
        from_user:{
            uid: ,
            username: ' ',
            image
        },
        gid,
        date:' '
    }
    

獲取求購評論

  • url:/v1.0/comments/wants/{{wid}}

  • methed:get

  • 參數
    {
    [page]
    }

  • 返回

    {
        name: ' ',
        comment:' ',
        to_user:{
            uid: ,
            username:' ',
            image:' '
        },
        from_user:{
            uid: ,
            username: ' ',
            image
        },
        wid,
        date:' '
    }
    

發布商品評論

  • url:/v1.0/comments/goods/{{gid}}//{{uid}}/{{token}}

  • methed:post

  • 參數
    {
    'comment':' ',
    }

  • 返回

    {
        'state':'ok'
    }
    

發布求購評論

  • url:/v1.0/comments/wants/{{wid}}//{{uid}}/{{token}}

  • methed:post

  • 參數
    {
    'comment':' ',
    }

  • 返回

    {
        'state':'ok'
    }
    

發送回執

  • url:/v1.0/feedback/{{uid}}/{{token}}

  • methed:post

  • 參數

    {
        'content':' '
    }
    
  • 返回

    {
        'state':' '
    }
    

上傳圖片

  • url :/v1.0/images

  • methed:post

  • 參數 (編碼格式 form-data)

    {
        'image': '你的圖片',
        ‘uid': ,
        'token': ,
    }
    
  • 返回

    {
        'hash':'',
        'key':' ',
    }
    
  • 訪問方法
    7xjejh.dl1.z0.glb.clouddn.com / + key

  • 圖片切割

    • goods
      增加參數 ?imageView2/1/w/800/h/800/q/75/format/JPG 返回jpg格式 800*800 px 的圖片
  • 例子
    上傳圖片后KEY 為 {{key}}
    http://7xjejh.dl1.z0.glb.clouddn.com /{{key}}?imageView2/1/w/800/h/800/q/75/format/JPG
    返回jpg格式 800*800 px 的圖片

舉報

  • url:/v1.0/reposts/{{uid}}//{{token}}

  • methed:post

  • 參數

    {
        'id': , //gid or wid
       'type':' 舉報商品還是求購'// good or want,
        'content':' 舉報內容'
    }
    
  • 返回

    {
        'state': 'ok', 
    }
    

查看用戶發布的商品

  • url:/v1.0/users/goods/{{uid}}/{{token}}

  • methed:get

  • 參數

        {
               [page] : ',
        } 
    
  • 返回

     [
    {
        "name": "",
        "views": ,
        "price": ,
        "gid": ,
        "date": "",
        "image": " "
    },
    ...
    ]
    
    

查看用戶發布的求購

  • url:/v1.0/users/wants/{{uid}}/{{token}}

  • methed:get

  • 參數

        {
               [page] : ',
        } 
    
  • 返回

    [
    {
        "school": "",
        "wid": ,
        "name": "",
        "views": ,
        "price": ,
        "date": " "
    },
    ...
    ]
    
    
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,316評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,481評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,241評論 0 374
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,939評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,697評論 6 409
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,182評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,247評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,406評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,933評論 1 334
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,772評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,973評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,516評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,209評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,638評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,866評論 1 285
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,644評論 3 391
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,953評論 2 373

推薦閱讀更多精彩內容

  • Spring Cloud為開發人員提供了快速構建分布式系統中一些常見模式的工具(例如配置管理,服務發現,斷路器,智...
    卡卡羅2017閱讀 134,781評論 18 139
  • 點擊查看原文 Web SDK 開發手冊 SDK 概述 網易云信 SDK 為 Web 應用提供一個完善的 IM 系統...
    layjoy閱讀 13,832評論 0 15
  • # 一度蜜v3.0協議 --- # 交互協議 [TOC] ## 協議說明 ### 請求參數 下表列出了v3.0版協...
    c5e350bc5b40閱讀 659評論 0 0
  • 我要去尋找我的圣地, 一個他人未及之地。 那里有我愛聽的鳥兒的歡唱, 有我愛聞的野草的芬芳。 天明有蔚藍深邃的天空...
    鳥嘴蘿卜頭閱讀 254評論 1 1
  • 滴答滴答,一夜的雨聲伴著久違的心情酣睡,讓日見干枯的心田得以滋潤; 喜歡雨,一種心情...
    阿莢閱讀 300評論 0 3