悠悠校园后台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阅读 211,884评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,347评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,435评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,509评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,611评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,837评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,987评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,730评论 0 267
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,194评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,525评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,664评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,334评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,944评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,764评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,997评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,389评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,554评论 2 349

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,633评论 18 139
  • 点击查看原文 Web SDK 开发手册 SDK 概述 网易云信 SDK 为 Web 应用提供一个完善的 IM 系统...
    layjoy阅读 13,702评论 0 15
  • # 一度蜜v3.0协议 --- # 交互协议 [TOC] ## 协议说明 ### 请求参数 下表列出了v3.0版协...
    c5e350bc5b40阅读 641评论 0 0
  • 我要去寻找我的圣地, 一个他人未及之地。 那里有我爱听的鸟儿的欢唱, 有我爱闻的野草的芬芳。 天明有蔚蓝深邃的天空...
    鸟嘴萝卜头阅读 247评论 1 1
  • 滴答滴答,一夜的雨声伴着久违的心情酣睡,让日见干枯的心田得以滋润; 喜欢雨,一种心情...
    阿荚阅读 295评论 0 3