悠悠校园后台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": " "
},
...
]

最后编辑于：2017.11.27 02:38:23

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 206,013评论 6赞 481
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 88,205评论 2赞 382
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 152,370评论 0赞 342
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 55,168评论 1赞 278
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 64,153评论 5赞 371
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,954评论 1赞 283
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 38,271评论 3赞 399
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,916评论 0赞 259
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 43,382评论 1赞 300
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,877评论 2赞 323
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,989评论 1赞 333
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,624评论 4赞 322
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 39,209评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 30,199评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,418评论 1赞 260
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 45,401评论 2赞 352
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,700评论 2赞 345

悠悠校园后台api

域名和端口

请求格式

错误返回

详细使用

用户认证

用户取消认证

获取用户信息

注册

修改用户信息

获取用户权限手机号是否公开，收藏是否公开

修改用户权限手机号是否公开，收藏是否公开

查看签到信息

签到

搜索用户

获取分类商品

获取商品详情

获取首页最新商品

搜索商品

发布商品

修改商品信息

下架货物

重新上架货物

获取分类求购

获取求购详情

获取首页最新求购信息

搜索求购

发布求购信息

修改求购信息

删除求购信息

获取当前用户收藏商品信息

获取当前用户收藏求购信息

获取制定用户收藏商品信息

获取指定用户收藏求购信息

新增商品收藏

新增求购收藏

删除商品收藏

删除求购收藏

获取一级分类分类信息

获取一级分类下所有二级分类信息

获取商品评论

获取求购评论

发布商品评论

发布求购评论

发送回执

上传图片

举报

查看用户发布的商品

查看用户发布的求购

推荐阅读更多精彩内容