get_friendship

Description

Get the detail of the single relationship between the specified origin user and the targed user.

URL

https://social.topoos.com/VERSION/USR/friendship.FORMAT

Available Format

JSON

HTTP Method

GET

Accepted Version

1

Require

Authorization.

Headers

Parameters

  • access_token: (Required) access_token to current authorized user resources.
  • USR: (Required) origin user identifier to get its relationships counters. You can use the special value “me” for this parameter, to get the counters of the current authenticated user.
  • usr_b: (Required) target user identifier to get wich relationships has the origin user with him.

Example

https://social.topoos.com/1/me/friendship.json?access_token=bcbb1a82-df15-47ca-b48a-0d2abb33d4ee&usr_b=9e002145-09e2-4476-a270-3c812a92f5a5

Reply

JSON example reply

{
   "status":{
      "description":"ok"
   },
   "relationship":{
      "user_id":"9e002145-09e2-4476-a270-3c812a92f5a5",
      "name":"kratos",
      "connections":[
         "followed_by"
      ]
   }
}

In the example: the current user is following the target user (kratos), (or kratos is followed_by the current user).