检查好友关系

检查用户与其他用户之间的好友关系。

开通服务

调用此接口前，您须在控制台开通信息托管服务。

请求方法

POST： https://数据中心域名/friend/check.json

频率限制： 每秒钟限 100 次 (注: 按照批量数量限频,即一次性检查10个好友,则算发起10次调用)

签名规则： 所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数

HTTP 请求正文数据格式为 application/x-www-form-urlencoded，支持以下 HTTP 表单参数：

参数	类型	必传	说明
userId	String	是	操作用户id
targetIds	String[]	是	待检查好友关系的目标用户id列表,最多支持传递100个用户id

请求示例

POST /friend/check.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

userId=id1&targetIds=id2,id3,id4

返回结果

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值	返回类型	说明
code	Number	返回码，200 为正常。
results	Object[]	检查结果列表
results[i].userId	String	目标用户id
results[i].result	Number	1.操作方不是目标方好友，目标方也不是操作方好友 2.预留字段,暂不返回 3.预留字段,暂不返回 4.操作方是目标方好友，目标方也是操作方好友

返回结果示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "code": 200,
    "results":[
      {
        "userId":"id2",
        "result":1
      },
      {
        "userId":"id3",
        "result":2
      },
      {
        "userId":"id4",
        "result":3
      }
    ]
}