差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- story [2014/09/03 20:33]
106.2.171.114 创建
+++ story [2014/09/29 19:20]
106.2.171.114
@@ 行 1: / 行 1: @@
-{
-	"reason": "故事发表成功！",
+===== 故事接口 =====
+==== 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">
+字故事内容：<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": [
@@ 行 30: / 行 77: @@
 			"140746712580530",
 			"140747002963590"
-		],
+		]
-		"story_id": "4"
+	}
+	}
+  * 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|返回首页]]

热拍API接口文档

站点工具

差别

页面工具