跳至内容
热拍API接口文档
站点工具
工具
显示页面
修订记录
反向链接
最近更改
媒体管理器
网站地图
最近更改
媒体管理器
网站地图
您的足迹:
story
您载入了该文档旧的修订版!
如果您保存了它,您就会用这些数据创建一份新的修订版。
媒体文件
===== 故事接口 ===== ==== 1、故事文本、照片上传接口(客户端调用,POST方式上传) ==== ''https://m.repai.com/story/story_upload_api/access_token/rpat_47be0653fe75e8ae3f3d4fa5de931c24'' 其中 rpat_47be0653fe75e8ae3f3d4fa5de931c24 为 access_token 示例。 === 输入参数说明: === * access_token 【调用[[reg_login_api|一键注册登陆接口]]获取到的access_token】 * POST内容 【form表单方式上传,构造的form表单格式示例如下,本地照片的name名称需要命名为upload[],商品ID的name名称为rp_iids[],故事文本内容的name名称为message,编码格式需要为multipart/form-data。至少1个商品ID,商品ID+本地照片之和最多为9。可以从[[browser_history|浏览历史]]中选择商品,将被选择的商品ID,写入到rp_iids[]的value值中。】 <form action="https://m.repai.com/story/story_upload_api/access_token/rpat_47be0653fe75e8ae3f3d4fa5de931c24" method="post" enctype="multipart/form-data"> 140字故事内容:<input name="message" type="text" value="这是一篇故事的内容,不知道大家是否喜欢?" /><br /> 商品ID1:<input name="rp_iids[]" type="text" value="140746712580530" /><br /> 商品ID2:<input name="rp_iids[]" type="text" value="140747002963590" /><br /> 本地照片1:<input name="upload[]" type="file" /><br /> 本地照片2:<input name="upload[]" type="file" /><br /> 本地照片3:<input name="upload[]" type="file" /><br /> 本地照片4:<input name="upload[]" type="file" /><br /> 本地照片5:<input name="upload[]" type="file" /><br /> 本地照片6:<input name="upload[]" type="file" /><br /> 本地照片7:<input name="upload[]" type="file" /><br /> <input type="submit" name="Submit" value="上传" /> </form> HTML表单上传文件网址示例:http://doc.repai.com/example/story_upload.htm (注意:示例地址为7张本地图片选择框,必须选择7张照片) ---- === 输出参数说明: === * JSON格式输出,错误时,status值为false,reason为失败原因,示例如下: { "reason": "提交失败,故事内容不能超过120个字!", "status": false } * JSON格式输出,正确时,status值为true,表示上传成功,示例如下: { "status": true, "reason": "故事发表成功!", "story_info": { "story_id": "4", "message": "这是一篇故事的内容,不知道大家是否喜欢?", "photos": [ { "pic_url": "http://pic.repaiapp.com/pic/09/18/65/0918654bc15b888ef24070e1c6627a76a48bd58d.png" }, { "pic_url": "http://pic.repaiapp.com/pic/cf/c9/98/cfc998598dbf4b90dff4214a8bbae4ccd2899887.png" }, { "pic_url": "http://pic.repaiapp.com/pic/09/18/65/0918654bc15b888ef24070e1c6627a76a48bd58d.png" }, { "pic_url": "http://pic.repaiapp.com/pic/09/18/65/0918654bc15b888ef24070e1c6627a76a48bd58d.png" }, { "pic_url": "http://pic.repaiapp.com/pic/cf/c9/98/cfc998598dbf4b90dff4214a8bbae4ccd2899887.png" }, { "pic_url": "http://pic.repaiapp.com/pic/09/18/65/0918654bc15b888ef24070e1c6627a76a48bd58d.png" }, { "pic_url": "http://pic.repaiapp.com/pic/cf/c9/98/cfc998598dbf4b90dff4214a8bbae4ccd2899887.png" } ], "rp_iids": [ "140746712580530", "140747002963590" ] } } * story_id 【故事ID】 ---- ==== 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|返回首页]]
编辑摘要
当您选择开始编辑本页,即寓示你同意将你贡献的内容按下列许可协议发布:
CC Attribution-Noncommercial-Share Alike 3.0 Unported
story.1411989615.txt.gz
· 最后更改: 2014/09/29 19:20 由
106.2.171.114
页面工具
显示页面
修订记录
反向链接
回到顶部