用户自定义分组
(→更新用户所在自定义分组) |
(→设置自定义规则分组) |
||
第25行: | 第25行: | ||
− | ''' | + | '''返回说明:''' |
<pre> | <pre> | ||
+ | //成功返回 | ||
{ | { | ||
"group": { | "group": { | ||
第33行: | 第34行: | ||
} | } | ||
} | } | ||
− | |||
− | + | //失败返回 | |
− | + | ||
− | + | ||
{ | { | ||
"request": "XXXX/messages/custom_rule/create", | "request": "XXXX/messages/custom_rule/create", |
2014年5月8日 (四) 16:42的版本
目录 |
设置自定义规则分组
接口调用请求说明:
URL:/messages/custom_rule/create.json HTTP 请求方式:POST 是否需要登录:是 授权限制:频次限制是
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
uid | true | long | 用户ID |
name | true | string | 分组名 |
返回说明:
//成功返回 { "group": { "id": 123123123123, //分组id "name": "test" //分组名 } } //失败返回 { "request": "XXXX/messages/custom_rule/create", "errcode": "1000XX", "errmsg": "error message." }
删除自定义规则分组
接口调用请求说明:
URL:/messages/custom_rule/delete.json HTTP 请求方式:POST 是否需要登录:是 授权限制:频次限制是
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
uid | true | long | 用户ID |
id | true | long | 要删除的组ID |
返回结果:
{ "errcode": 0, "errmsg": "ok" }
失败返回:
{ "request": "XXXX/messages/custom_rule/delete", "errcode": "1000XX", "errmsg": "error message." }
修改自定义规则分组
接口调用请求说明:
URL:/messages/custom_rule/update.json HTTP 请求方式:POST 是否需要登录:是 授权限制:频次限制是
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
uid | true | long | 用户ID |
id | true | long | 分组ID |
name | true | string | 分组名 |
返回结果:
{ "errcode": 0, "errmsg": "ok" }
失败返回:
{ "request": "XXXX/messages/custom_rule/update", "errcode": "1000XX", "errmsg": "error message." }
获取自定义规则分组
接口调用请求说明:
URL:/messages/custom_rule/get.json HTTP 请求方式:POST 是否需要登录:是 授权限制:频次限制是
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
uid | true | long | 用户ID |
rule_type | false | int | 获取规则 定义;默认不传返回所有自定义分组;1只返回自动分组;2返回全部分组信息 |
返回结果:
{ "groups": [ { "id": 0, "name": "未分组", "count": 72596, "rule_type": 1 //0:私密自动规则;1:开放自动规则 }, { "id": 1, "name": "黑名单", "count": 36, "rule_type": 2 //2:自定义分组 } ] }
失败返回:
{ "request": "XXXX/messages/custom_rule/get", "errcode": "1000XX", "errmsg": "error message." }
查询用户所在自定义分组
接口调用请求说明:
URL:/messages/custom_rule/getid.json HTTP 请求方式:POST 是否需要登录:是 授权限制:频次限制是
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
uid | true | long | 用户ID |
follower_id | true | long | 粉丝id |
返回结果:
{ "groupid": 123123123 }
失败返回:
{ "request": "XXXX/messages/custom_rule/getid", "errcode": "1000XX", "errmsg": "error message." }
更新用户所在自定义分组
接口调用请求说明:
URL:/messages/custom_rule/member/update.json HTTP 请求方式:POST 是否需要登录:是 授权限制:频次限制是
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
uid | true | long | 用户ID |
follower_id | true | long | 粉丝id |
to_groupid | true | long | 分组id |
返回结果:
{ "errcode": 0, "errmsg": "ok" }
失败返回:
{ "request": "XXXX/messages/custom_rule/member/update", "errcode": "1000XX", "errmsg": "error message." }