热拍API接口文档

站点工具

您的足迹: • story
story

这是本文档旧的修订版！

目录

故事接口

1、故事文本、照片上传接口（客户端调用，POST方式上传）

https://m.repai.com/story/story_upload_api/access_token/rpat_47be0653fe75e8ae3f3d4fa5de931c24

其中 rpat_47be0653fe75e8ae3f3d4fa5de931c24 为 access_token 示例。

输入参数说明：

  • POST内容 【form表单方式上传，构造的form表单格式示例如下，本地照片的name名称需要命名为upload[]，商品ID的name名称为rp_iids[]，故事文本内容的name名称为message，编码格式需要为multipart/form-data。至少1个商品ID，商品ID+本地照片之和最多为9。可以从浏览历史中选择商品，将被选择的商品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】

输出参数说明：

{
"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 【用户昵称，无昵称时，显示进行*处理的手机号，例如：1593960】
  • 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

输入参数说明：

  • 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 示例。

输入参数说明：

  • 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 笔记本电脑鼠标超薄有线可爱省电 办公鼠标 包邮"
	}
]
}

返回首页

story.1411989615.txt.gz · 最后更改: 2014/09/29 19:20 由 106.2.171.114

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Noncommercial-Share Alike 3.0 Unported
CC Attribution-Noncommercial-Share Alike 3.0 Unported Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki