发表记录

接口说明

发布一条记录(可以带一张图片)。所有接口仅支持UTF-8格式中文编码

访问权限

需设置 scope=create_records 才能访问。详细说明请参考接口访问权限说明

请求URL地址

OAuth1.0a access token方式:http://api.kaixin001.com/records/add.(json|xml)
OAuth2.0 access token方式:https://api.kaixin001.com/records/add.(json|xml)
session key方式:https://api.kaixin001.com/records/add.(json|xml)

支持格式

XML/JSON

是否使用HTTPS连接

OAuth1.0a access token方式:否
OAuth2.0 access token方式:是
session key方式:是

HTTP请求方式

POST

是否需要登录

TRUE

调用示例

请求参数说明

api参数
参数名必选说明
content True发记录的内容(最多140个汉字或280个英文字母字符),不支持{_USER_}等
save_to_album False是否存到记录相册中,0/1-不保存/保存,默认为0不保存
location False记录的地理位置(目前仅在“我的记录”列表中显示)
lat False纬度 -90.0到+90.0,+表示北纬(目前暂不能显示)
lon False经度 -180.0到+180.0,+表示东经(目前暂不能显示)
sync_status False是否同步签名 0/1/2-无任何操作/同步/不同步,默认为0无任何操作
spri False权限设置,0/1/2/3-任何人可见/好友可见/仅自己可见/好友及好友的好友可见
默认为0任何人可见
pic False发记录上传的图片,图片在10M以内,格式支持jpg/jpeg/gif/png/bmp
*pic和picurl只能选择其一,两个同时提交时,只取pic
* oauth1.0,pic参数不需要参加签名
picurl False外部图片链接,图片在10M以内,格式支持jpg/jpeg/gif/png/bmp
*pic和picurl只能选择其一,两个同时提交时,只取pic
skip_news False是否不发动态,0/1-发动态/不发动态,默认为0发动态
sourceid False需要向平台申请,用来自定义来源名称
rcode False验证码验证需要的rcode,需要验证码验证时才需此参数,见返回数据说明
code False用户输入的验证码,需要验证码验证时才需此参数
OAuth1.0验证参数

oauth_token: 登录用户的token,用于验证该调用请求是否为当前用户发出的。

oauth_consumer_key:应用的App Key。

oauth_signature_method:签名方法,暂只支持HMAC-SHA1。

oauth_signature:签名值,密钥为oauth_comsumer_secret和oauth_token_secret以&作为分隔符拼起来。

oauth_timestamp:时间戳, 其值是距1970 00:00:00 GMT的秒数。

oauth_nonce:单次值,随机生成的32位字符串,防止重放攻击(每次请求必须不同)。

oauth_version:(可选) 版本号,如果有必须为 1.0 。

OAuth2.0验证参数

access_token:授权的access token。

调试工具地址

返回结果示例

XML示例:

<?xml version="1.0" encoding="UTF-8"?> 
<rid>
	1374838629035913
</rid>

JSON示例:

{"rid":"1374838581980400"}

返回结果字段说明

字段说明类型
rid 记录IDstring

返回下面的字段时 需要用户输入验证码后重新调用接口

rcode 随机串,校验验证码时传需要传入此参数string
captcha_url 验证码图片urlstring
captcha_wrong 为1表示验证码输入错误string

错误代码释义

常见问题

40031 记录:上传照片出错

若文件路径没错,请检查pic参数的content-type是否是开心网支持的以下5种格式:jpg/jpeg/gif/png/bmp
注:照片文件及其它参数以multiPart的方式传递

40036 记录:提交内容超过最大长度

最多140个汉字,280个英文

40043 记录:picurl下载错误

1、picurl必须能在公网上访问,不能有登录验证,不能跳转。
2、picurl需以图片格式结尾。

中文乱码或最后两个字丢失

API2.0统一编码为UTF-8,调用接口时中文参数必须使用UTF-8编码

用户开心网首页有记录,记录接口却返回空

首页显示的是动态,不是单纯的记录;记录接口的内容与左侧记录应用的内容一致。

看不到发布的记录、动态

1、由于缓存的原因请2~3分钟后重试
2、用户看不到自己的动态,只能看到好友的动态。可通过“首页”->“好友访问时”查看
3、用户开心网首页,同一好友的动态数是有限制,有时只能看到好友最新的3条动态。点击底部的“查看更多”可以看到全部动态。

发记录时如何@好友

格式为@uid (uid后必须有一个空格)
注:跟uid是好友关系时才会转换为姓名

获取记录中的大图

返回图片地址中的 _records-s 换成 _records-m

字数限制问题

记录:400字(中文),URL链接不算字数

验证码

触发验证码后需要用户手动输入验证码,开发者获取用户输入内容后再次调用接口