2/messages/invite
(以“=好友邀请接口= 功能： 好友邀请接口，支持登录用户向自己的微博互粉好友发送私信邀请 接口调用地址：https://m.api.weibo.com...”为内容创建页面) |
|||
| 第72行： | 第72行： | ||
} | } | ||
</pre> | </pre> | ||
| − | + | ||
| + | 将json采用UTF-8编码进行URLEncode后对应data参数值为： | ||
<pre class="brush:js"> | <pre class="brush:js"> | ||
"%7b%0a++++%22text%22%3a+%22%e8%bf%99%e4%b8%aa%e6%b8%b8%e6%88%8f%e5%a4%aa%e5%a5%bd%e7%8e%a9%e4%ba%86%ef%bc%8c%e5%8a%a0%e5%85%a5%e4%b8%80%e8%b5%b7%e7%8e%a9%e5%90%a7%22%2c%0a++++%22url%22%3a+%22http%3a%2f%2fapp.sina.com.cn%2fappdetail.php%3fappID%3d770915%22%2c%0a++++%22invite_logo%22%3a+%22http%3a%2f%2fhubimage.com2us.com%2fhubweb%2fcontents%2f123_499.jpg%22%0a%7d"。 | "%7b%0a++++%22text%22%3a+%22%e8%bf%99%e4%b8%aa%e6%b8%b8%e6%88%8f%e5%a4%aa%e5%a5%bd%e7%8e%a9%e4%ba%86%ef%bc%8c%e5%8a%a0%e5%85%a5%e4%b8%80%e8%b5%b7%e7%8e%a9%e5%90%a7%22%2c%0a++++%22url%22%3a+%22http%3a%2f%2fapp.sina.com.cn%2fappdetail.php%3fappID%3d770915%22%2c%0a++++%22invite_logo%22%3a+%22http%3a%2f%2fhubimage.com2us.com%2fhubweb%2fcontents%2f123_499.jpg%22%0a%7d"。 | ||
2013年8月27日 (二) 11:19的版本
好友邀请接口
功能： 好友邀请接口，支持登录用户向自己的微博互粉好友发送私信邀请
接口调用地址：https://m.api.weibo.com/2/messages/invite.json
HTTP请求方式：POST
是否需要登陆：是
频次限制：是
| 接口请求参数 | |||
|---|---|---|---|
| 参数名称 | 值的类型 | 是否必填 | 说明描述 |
| access_token | string | true | 采用OAuth授权方式为必填参数，其他授权方式不需要此参数，OAuth授权后获得。 |
| uid | int64 | true | 被邀请人，需为当前用户互粉好友。 |
| data | string | true | 邀请数据。必须为json字串的形式，必须做URLEncode，采用UTF-8编码。 |
注意事项
- 1, 当前用户需要先完成Scope 授权，对应的scope权限参数为：invitation_write；
- 2, 指定的uid用户必须为当前登录用户的互粉好友；
- 3, 每用户通过每应用每小时只能邀请10个互粉好友。
data参数支持的参数：
| data支持的参数描述 | |||
|---|---|---|---|
| 参数名称 | 值的类型 | 是否必填 | 说明描述 |
举例，当data对应json为：
{
"text": "这个游戏太好玩了，加入一起玩吧",
"url": "http://app.sina.com.cn/appdetail.php?appID=770915",
"invite_logo": "http://hubimage.com2us.com/hubweb/contents/123_499.jpg"
}
将json采用UTF-8编码进行URLEncode后对应data参数值为：
"%7b%0a++++%22text%22%3a+%22%e8%bf%99%e4%b8%aa%e6%b8%b8%e6%88%8f%e5%a4%aa%e5%a5%bd%e7%8e%a9%e4%ba%86%ef%bc%8c%e5%8a%a0%e5%85%a5%e4%b8%80%e8%b5%b7%e7%8e%a9%e5%90%a7%22%2c%0a++++%22url%22%3a+%22http%3a%2f%2fapp.sina.com.cn%2fappdetail.php%3fappID%3d770915%22%2c%0a++++%22invite_logo%22%3a+%22http%3a%2f%2fhubimage.com2us.com%2fhubweb%2fcontents%2f123_499.jpg%22%0a%7d"。
返回结果
// 成功返回
{
"id": 1211260020031347,
"type": "invite",
"recipient_id": 1902538057,
"sender_id": 2489518277,
"created_at": "Mon Jul 16 18:09:20 +0800 2012",
"text": "这个游戏太好玩了，加入一起玩吧。http://t.cn/zHpnpxj",
"data": {
"url": "http://t.cn/zHpnpxj",
"invite_logo": "http://hubimage.com2us.com/hubweb/contents/123_499.jpg"
}
}
// 失败返回
{
"request": "/2/messages/invite.json",
"error_code": "264XX",
"error": "error message."
}
