Friend.areFriends
出自Manyou开发者指南
目录 |
描述
返回两个用户是否为好友。是好友时返回 1 或 true,不是好友时返回 0 或 false。
参数
| 必选性 | 参数名 | 类型 | 描述 | |
| 必选 | api_key | string | 申请应用时生成的 API Key。 | |
|---|---|---|---|---|
| session_key | string | 当前登录用户的 Session Key。 | ||
| call_id | float | 请求序列值。每个请求都有一个序列值,并且后一个比前一个大,序列值和 session 无关。我们建议您使用以毫秒为单位的当前时间的值,类似 PHP 中的 microtime(true) 函数。 | ||
| sig | string | MD5 串。根据当前请求和 Secret 值加密获得。 | ||
| v | string | 本参数的值必须设置为 1.0,表示 API 的版本号。 | ||
| uid1 | array | 第一个用户的 ID。 | ||
| uid2 | array | 第二个用户的 ID。 | ||
| 可选 | format | string | 指定响应返回的格式。有 PHP (默认) 、 JSON 和 XML 这三种值可选。 |
请求范例
| 本例使用的是 PHP 客户端: // 实例化Manyou类库 $manyou = new Manyou($api_key, $api_secret); $isAppAdded = $manyou->api_client->friend_areFriends(1591209, 1591108); |
JSON返回结果范例
| "true" |
返回值
注意: 当用户对 Manyou 平台不可见或好友信息对某用户不可见时,本方法仍然会返回指定的数据。
MYQL环境
本方法效果和以下 MYQL 查询类似:
| SELECT uid1, uid2 FROM friend WHERE uid1=uid1 AND uid2=uid2 |
错误代码
| 错误代码 | 描述 | |
| 1 | 发生了一个未知错误,请重新提交请求。 | |
|---|---|---|
| 2 | 目前服务不可用。 | |
| 4 | 应用请求已达到最大允许请求次数。 | |
| 5 | IP 地址被禁止。 | |
| 100 | 无效的参数。 | |
| 101 | 无效的 API Key。 | |
| 102 | 无效或已超时的 Session Key。请将用户引导至登陆页面以获得一个新的 Session Key。 | |
| 104 | 无效的签名值。 |
