Friends.areFriends
出自海内开放平台
目录 |
描述
判断两组用户是否互为好友关系，比较的两组用户数必须相等。
参数
| Required | Name | Type | Description |
| required | api_key | string | 本应用程序对应的 API key 。 |
| call_id | float | 保持递增的序列，同一 session 后一请求的值应大于前一请求的值。推荐使用当前微秒时间值，比如 PHP 的 microtime 函数。 | |
| v | string | 版本号，请设置为 1.0 。 | |
| sig | string | 签名，即当前请求与 secret key 合并后的字符串的 MD5 值。请参考 海内识别应用程序方法。 | |
| session_key | string | 登录用户的 session key 。 | |
| uids1 | array | 第一组用户的ID，每个ID之间以逗号分隔 | |
| uids2 | array | 第二组用户的ID，每个ID之间以逗号分隔 | |
| optional | format | string | 希望返回的数据格式。可以是 XML(默认) 或者 JSON 格式。 |
调用示例
| $areFriends = $hainei->apiClient->friends_areFriends(array(100002, 100002), array(100006, 200001)); |
返回XML样例
| <?xml version="1.0" encoding="UTF-8"?> <friends_arefriends_response xmlns="http://api.hainei.com/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.hainei.com/1.0/ http://api.hainei.com/1.0/hainei.xsd" list="true"> <friend_info> <uid1>100002</uid1> <uid2>100006</uid2> <are_friends>1</are_friends> </friend_info> <friend_info> <uid1>100002</uid1> <uid2>200001</uid2> <are_friends>0</are_friends> </friend_info> </friends_arefriends_response> |
返回JSON样例
| [{"uid1":100002,"uid2":100006,"are_friends":true},{"uid1":100002,"uid2":200001,"are_friends":false}] |
错误码
| Code | Description |
|---|---|
| 1 | 未知错误，需重新发送请求 |
| 2 | 服务不可用 |
| 4 | 应用程序请求次数过多 |
| 5 | 访问 IP 错误 |
| 100 | 参数错误 |
| 101 | API key 错误 |
| 102 | Session key 错误或已失效，需要重定向到登录页面 |
| 103 | call_id 错误，同一 session 后一请求的值应大于前一请求的值。 |
| 104 | 签名错误 |
