站点工具


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、故事读取接口(所有用户上传的故事)

输入参数说明:

  • sort 【排序方式,可选参数为:time按照发布时间排序;clicks按照点击数排序;comment按照评论数/赞数排序。目前暂时只支持time】
  • type 【故事审核状态:1为发布并自动显示在公共列表;2为被内容违法或广告贴被编辑删除】
  • offset 【记录偏移量】
  • limit 【显示记录数量,结合 offset 用来做分页,下拉加载更多;offset/0/limit/50相当于SQL语句中的limit 0,50】
  • 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": "这是一篇故事的内容,不知道大家是否喜欢?",
		"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袋 "
			}
		],
		"story_id": "11"
	},
	{
		"message": "你好,你好,你好你好,你好你好,你好你好,你好你好,你好你好,你好你好,你好你好,你好",
		"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袋 "
			},
			null,
			null,
			null,
			null
		],
		"story_id": "10"
	}
]
}

返回首页

story.1410258018.txt.gz · 最后更改: 2014/09/09 18:20 由 106.2.171.114