这里会显示出您选择的修订版和当前版本之间的差别。
Both sides previous revision 前一修订版 | |||
story [2014/09/29 19:20] 106.2.171.114 |
story [2014/10/08 12:56] (当前版本) 106.2.171.114 |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ===== 故事接口 ===== | + | ===== 故事文本、照片上传接口 ===== |
==== 1、故事文本、照片上传接口(客户端调用,POST方式上传) ==== | ==== 1、故事文本、照片上传接口(客户端调用,POST方式上传) ==== | ||
行 85: | 行 85: | ||
---- | ---- | ||
- | |||
- | |||
- | ==== 2、故事读取接口(所有用户上传的故事) ==== | ||
- | |||
- | ''https://m.repai.com/story/story_total_get_api/sort/time/type/1/offset/0/limit/10/appkey/100002/appoid/test?access_token=rpat_47be0653fe75e8ae3f3d4fa5de931c24'' | ||
- | |||
- | === 输入参数说明: === | ||
- | |||
- | * sort 【排序方式,可选参数为:time按照发布时间排序;clicks按照点击数排序;comment按照评论数/赞数排序。目前暂时只支持time】 | ||
- | |||
- | * type 【故事审核状态:1为发布并自动显示在公共列表;2为被内容违法或广告贴被编辑删除】 | ||
- | |||
- | * offset 【记录偏移量】 | ||
- | |||
- | * limit 【显示记录数量,结合 offset 用来做分页,下拉加载更多;offset/0/limit/10相当于SQL语句中的limit 0,10】 | ||
- | |||
- | * appkey 【热拍事业部买家版HTML5为100001,iOS为100002,Android为100003】 | ||
- | |||
- | * appoid 【设备的唯一ID,iOS手机取OpenUDID(下载地址:https://github.com/ylechelle/OpenUDID)作为唯一ID;#import “OpenUDID.h” 然后 NSLog(@“%@”,[OpenUDID value]); 打印出来的值即为OpenUDID,然后对OpenUDID做md5加密后的值,作为appoid】 | ||
- | |||
- | * access_token 【调用[[reg_login_api|一键注册登陆接口]]获取到的access_token】 | ||
- | |||
- | === 输出参数说明: === | ||
- | |||
- | { | ||
- | "current_count": 11, | ||
- | "is_end": true, | ||
- | "next_limit": 50, | ||
- | "next_offset": 50, | ||
- | "total": 11, | ||
- | "data": [ | ||
- | { | ||
- | "message": "这是一篇故事的内容,不知道大家是否喜欢?", | ||
- | "love_total_up": "0", | ||
- | "love_up": false, | ||
- | "avatar": "http://pic.repaiapp.com/pic/95/23/22/9523222a32b3cf16d3eaf0cf721153b9ca52896b.jpg@0e_120w_120h_0c_0i_1o_90Q_1x.jpg", | ||
- | "publish_time": "1410320543", | ||
- | "rp_province": "北京", | ||
- | "rp_city": "北京", | ||
- | "rp_phone": "15901283960", | ||
- | "rp_nick": "159****3960", | ||
- | "rp_uid": "1", | ||
- | "photos": [ | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/74/db/fe/74dbfec08545b578359464fa53fb8f9cc107876b.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/74/db/fe/74dbfec08545b578359464fa53fb8f9cc107876b.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/74/db/fe/74dbfec08545b578359464fa53fb8f9cc107876b.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/74/db/fe/74dbfec08545b578359464fa53fb8f9cc107876b.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/74/db/fe/74dbfec08545b578359464fa53fb8f9cc107876b.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/74/db/fe/74dbfec08545b578359464fa53fb8f9cc107876b.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/74/db/fe/74dbfec08545b578359464fa53fb8f9cc107876b.jpg" | ||
- | } | ||
- | ], | ||
- | "rp_iids": [ | ||
- | { | ||
- | "rp_iid": "1100940608817830", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100940608817830/", | ||
- | "rp_pic_url": "http://gd3.alicdn.com/imgextra/i3/T1dRQOFh0aXXXXXXXX_!!0-item_pic.jpg_320x320q90.jpg", | ||
- | "rp_price": "24", | ||
- | "rp_quantity": "50", | ||
- | "rp_title": "拍下24包邮 加绒加厚秋冬打底衫" | ||
- | }, | ||
- | { | ||
- | "rp_iid": "1100940324257215", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100940324257215/", | ||
- | "rp_pic_url": "http://gd2.alicdn.com/imgextra/i2/TB19IdUGXXXXXbuXFXXXXXXXXXX_!!0-item_pic.jpg_320x320q90.jpg", | ||
- | "rp_price": "2.8", | ||
- | "rp_quantity": "1000", | ||
- | "rp_title": "Diy皮筋手链 买8袋送8袋 " | ||
- | } | ||
- | ], | ||
- | "love": [ | ||
- | { | ||
- | "avatar": "http://pic.repaiapp.com/pic/95/23/22/9523222a32b3cf16d3eaf0cf721153b9ca52896b.jpg@0e_60w_60h_0c_0i_1o_90Q_1x.jpg", | ||
- | "nick": "159****3960", | ||
- | "appoid": "", | ||
- | "rp_uid": "1" | ||
- | }, | ||
- | { | ||
- | "avatar": "http://pic.repaiapp.com/image/other/avatar.png", | ||
- | "nick": "访客****test", | ||
- | "appoid": "test", | ||
- | "rp_uid": "" | ||
- | } | ||
- | ], | ||
- | "story_id": "11" | ||
- | }, | ||
- | { | ||
- | "message": "你好,你好,你好你好,你好你好,你好你好,你好你好,你好你好,你好你好,你好你好,你好", | ||
- | "love_total_up": "1", | ||
- | "love_up": true, | ||
- | "avatar": "http://pic.repaiapp.com/pic/95/23/22/9523222a32b3cf16d3eaf0cf721153b9ca52896b.jpg@0e_120w_120h_0c_0i_1o_90Q_1x.jpg", | ||
- | "publish_time": "1410320543", | ||
- | "rp_province": "北京", | ||
- | "rp_city": "北京", | ||
- | "rp_phone": "15901283960", | ||
- | "rp_nick": "159****3960", | ||
- | "rp_uid": "1", | ||
- | "photos": [ | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/47/cd/79/47cd7967e5514804bd412c7431899155b2f88519.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/81/df/38/81df385b0f314f0e122cf2edcb81ed6c65a44ca5.jpg" | ||
- | }, | ||
- | { | ||
- | "pic_url": "http://pic.repaiapp.com/pic/81/df/38/81df385b0f314f0e122cf2edcb81ed6c65a44ca5.jpg" | ||
- | } | ||
- | ], | ||
- | "rp_iids": [ | ||
- | { | ||
- | "rp_iid": "1100940608817830", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100940608817830/", | ||
- | "rp_pic_url": "http://gd3.alicdn.com/imgextra/i3/T1dRQOFh0aXXXXXXXX_!!0-item_pic.jpg_320x320q90.jpg", | ||
- | "rp_price": "24", | ||
- | "rp_quantity": "50", | ||
- | "rp_title": "拍下24包邮 加绒加厚秋冬打底衫" | ||
- | }, | ||
- | { | ||
- | "rp_iid": "1100940324257215", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100940324257215/", | ||
- | "rp_pic_url": "http://gd2.alicdn.com/imgextra/i2/TB19IdUGXXXXXbuXFXXXXXXXXXX_!!0-item_pic.jpg_320x320q90.jpg", | ||
- | "rp_price": "2.8", | ||
- | "rp_quantity": "1000", | ||
- | "rp_title": "Diy皮筋手链 买8袋送8袋 " | ||
- | } | ||
- | ], | ||
- | "love": [ | ||
- | { | ||
- | "avatar": "http://pic.repaiapp.com/pic/95/23/22/9523222a32b3cf16d3eaf0cf721153b9ca52896b.jpg@0e_60w_60h_0c_0i_1o_90Q_1x.jpg", | ||
- | "nick": "159****3960", | ||
- | "appoid": "", | ||
- | "rp_uid": "1" | ||
- | }, | ||
- | { | ||
- | "avatar": "http://pic.repaiapp.com/image/other/avatar.png", | ||
- | "nick": "访客****test", | ||
- | "appoid": "test", | ||
- | "rp_uid": "" | ||
- | } | ||
- | ], | ||
- | "story_id": "10" | ||
- | } | ||
- | ] | ||
- | } | ||
- | |||
- | * is_end 【 是否还有下一页,true为已结束,无下一页;false为未结束,还有下一页】 | ||
- | |||
- | * next_offset 【下一页的偏移量】 | ||
- | |||
- | * next_limit 【下一页的显示数量】 | ||
- | |||
- | * total 【总故事数量】 | ||
- | |||
- | * current_count 【本次显示的故事数量】 | ||
- | |||
- | * message 【故事文本内容】 | ||
- | |||
- | * love_total_up 【某篇故事总的喜欢数】 | ||
- | |||
- | * love_up 【当前用户对某篇故事是否喜欢】 | ||
- | |||
- | * avatar 【用户头像图片地址】 | ||
- | |||
- | * publish_time 【故事发布时间UNIX时间戳】 | ||
- | |||
- | * rp_province 【用户省份】 | ||
- | |||
- | * rp_city 【用户城市】 | ||
- | |||
- | * rp_phone 【用户手机号】 | ||
- | |||
- | * rp_nick 【用户昵称,无昵称时,显示进行*处理的手机号,例如:159****3960】 | ||
- | |||
- | * rp_uid 【用户ID】 | ||
- | |||
- | * photos 【用户上传的照片】 | ||
- | |||
- | * rp_iids 【商品图片及内容摘要】 | ||
- | |||
- | * love 【对当前故事点“赞”的登陆用户、未登陆用户列表:avatar头像,nick昵称,appoid匿名用户手机设备唯一ID,rp_uid登陆用户ID】 | ||
- | |||
- | ---- | ||
- | |||
- | |||
- | ==== 3、故事点“赞”接口 ==== | ||
- | |||
- | 未登陆用户点“赞”或“取消赞”,首次调用接口“点赞”,再次调用接口“取消赞”: | ||
- | |||
- | ''https://m.repai.com/story/story_love_put_api/appkey/100002/appoid/test/story_id/14/token/08069ccedc929ad9c46481b831ea0b54'' | ||
- | |||
- | 已登陆用户点“赞”或“取消赞”,首次调用接口“点赞”,再次调用接口“取消赞”: | ||
- | |||
- | ''https://m.repai.com/story/story_love_put_api/appkey/100002/appoid/test/story_id/14/token/08069ccedc929ad9c46481b831ea0b54/?access_token=rpat_47be0653fe75e8ae3f3d4fa5de931c24'' | ||
- | |||
- | === 输入参数说明: === | ||
- | |||
- | * access_token 【调用[[reg_login_api|一键注册登陆接口]]获取到的access_token】 | ||
- | |||
- | * token 【防篡改验证串,token值的组成为,以PHP代码为例:md5(“RP”.$appkey.$appsecret.$story_id.$appoid) 由客户端生成,其中 $appsecret为密钥,每个appkey对应的不同的密钥,密钥请询问张宴】 | ||
- | |||
- | * story_id 【故事ID】 | ||
- | |||
- | * appkey 【热拍事业部买家版HTML5为100001,iOS为100002,Android为100003】 | ||
- | |||
- | * appoid 【设备的唯一ID,iOS手机取OpenUDID(下载地址:https://github.com/ylechelle/OpenUDID)作为唯一ID;#import “OpenUDID.h” 然后 NSLog(@“%@”,[OpenUDID value]); 打印出来的值即为OpenUDID,然后对OpenUDID做md5加密后的值,作为appoid】 | ||
- | |||
- | === 输出参数说明: === | ||
- | |||
- | 点“赞”后的结果: | ||
- | |||
- | {"status":true,"reason":"+1","love":true} | ||
- | |||
- | 取消“赞”后的结果: | ||
- | |||
- | {"status":true,"reason":"-1","love":false} | ||
- | |||
- | 错误的结果: | ||
- | |||
- | { | ||
- | "reason": "TOKEN验证未通过,非法请求!", | ||
- | "status": false | ||
- | } | ||
- | |||
- | * status 【是否正常完成“点赞”和“取消赞”的操作,true是,false否】 | ||
- | |||
- | * reason 【status为false时显示错误原因,status为true显示+1或-1】 | ||
- | |||
- | * love 【为true时,表示操作后的状态为“赞”;为false时,表示操作后的状态值“取消赞”】 | ||
- | |||
- | |||
- | ---- | ||
- | |||
- | ==== 4、商品选取接口(客户端调用) ==== | ||
- | |||
- | 所有来源商品: | ||
- | |||
- | ''https://m.repai.com/story/story_items_get_api/source/10/appkey/100002/appoid/test?access_token=rpat_47be0653fe75e8ae3f3d4fa5de931c24'' | ||
- | |||
- | 指定来源商品: | ||
- | |||
- | ''https://m.repai.com/story/story_items_get_api/appkey/100002/appoid/test?access_token=rpat_47be0653fe75e8ae3f3d4fa5de931c24'' | ||
- | |||
- | 其中 rpat_47be0653fe75e8ae3f3d4fa5de931c24 为 access_token 示例。 | ||
- | |||
- | === 输入参数说明: === | ||
- | |||
- | * access_token 【调用[[reg_login_api|一键注册登陆接口]]获取到的access_token】 | ||
- | |||
- | * appkey 【热拍卖家版Android客户端的appkey为100005,iOS为100004;热拍买家版HTML5为100001,iOS为100002,Android为100003;校园微店iOS为100042,Android为100043;】 | ||
- | |||
- | * appoid 【设备的唯一ID,android手机取网卡mac地址的md5值作为唯一ID;iOS手机取OpenUDID的md5值作为唯一ID】 | ||
- | |||
- | * source 【商品来源:10来自手机浏览历史记录;20来自用户购买记录;30来自热拍精选(暂无数据);1020来自10+20;1030来自10+30;2030;来自20+30】 | ||
- | |||
- | ---- | ||
- | |||
- | |||
- | === 输出参数说明: === | ||
- | |||
- | * JSON格式输出,错误时,status值为false,示例如下: | ||
- | |||
- | { | ||
- | "status": false | ||
- | } | ||
- | |||
- | * JSON格式输出,正确时,status值为true,示例如下: | ||
- | |||
- | { | ||
- | "status": true, | ||
- | "data": [ | ||
- | { | ||
- | "clicks": "4", | ||
- | "rp_iid": "1100940866488224", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100940866488224/?appoid=test&appkey=100002", | ||
- | "rp_pic_url": "http://img04.taobaocdn.com/imgextra/i4/1826851938/TB2JtNHapXXXXaoXXXXXXXXXXXX_!!1826851938.jpg_320x320q90.jpg", | ||
- | "rp_price": "9.9", | ||
- | "rp_quantity": "1000", | ||
- | "rp_title": "万能不锈钢夹碗器 居家必备" | ||
- | }, | ||
- | { | ||
- | "clicks": "3", | ||
- | "rp_iid": "1100047807283732", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100047807283732/?appoid=test&appkey=100002", | ||
- | "rp_pic_url": "http://img01.taobaocdn.com/imgextra/i1/769611264/TB23UlpapXXXXcYXXXXXXXXXXXX_!!769611264.jpg_320x320q90.jpg", | ||
- | "rp_price": "8.5", | ||
- | "rp_quantity": "800", | ||
- | "rp_title": "不锈钢餐具套装便携带式餐具三件套" | ||
- | }, | ||
- | { | ||
- | "clicks": "5", | ||
- | "rp_iid": "1100047016242904", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100047016242904/?appoid=test&appkey=100002", | ||
- | "rp_pic_url": "http://img04.taobaocdn.com/imgextra/i4/604903634/TB2AVFsXFXXXXaYXpXXXXXXXXXX_!!604903634.jpg_320x320q90.jpg", | ||
- | "rp_price": "3.5", | ||
- | "rp_quantity": "1000", | ||
- | "rp_title": "通用带麦入耳式耳机好评返两元" | ||
- | }, | ||
- | { | ||
- | "clicks": "5", | ||
- | "rp_iid": "1100940885858404", | ||
- | "rp_item_url": "http://m.repai.com/item/view/id/1100940885858404/?appoid=test&appkey=100002", | ||
- | "rp_pic_url": "http://gw.alicdn.com/bao/uploaded/i3/TB1o04qFVXXXXagXVXXXXXXXXXX_!!0-item_pic.jpg_320x320q90.jpg", | ||
- | "rp_price": "10.5", | ||
- | "rp_quantity": "50", | ||
- | "rp_title": "玛尚A18 笔记本电脑鼠标超薄有线可爱省电 办公鼠标 包邮" | ||
- | } | ||
- | ] | ||
- | } | ||
- | |||
[[start|返回首页]] | [[start|返回首页]] |