Go back to Partigi API Documentation

friendships/show

Returns information of the relationship between two users.

URL:

http://www.partigi.com/api/v1/friendships/show.format

Formats:

atom, json (more about JSON responses)

HTTP Methods:

GET 

Authentication Mode:

read-only (when authorization token is used the source_id will be set to the authenticated user by default)

Parameters:

Required:

• source_id: The ID or login of the subject user.
• target_id: The ID or login of the target user.

Request example:

http://www.partigi.com/api/v1/friendships/show.atom?source_id=wadus&target_id=tradus

Response example:

  <?xml version="1.0" encoding="UTF-8"?>
  <feed xmlns="http://www.w3.org/2005/Atom">
    <title>Friendship between wadus and tradus</title>
    <id>http://www.partigi.com/api/v1/friendships/show.atom?source_id=wadus&target_id=tradus</id>
    <updated>2009-07-09T07:38:50Z</updated>
    <link type="application/atom+xml" href="http://www.partigi.com/api/v1/friendships/show.atom?source_id=wadus&target_id=tradus" rel="self"/>
    <author>
      <name>wadus</name>
      <uri>http://www.partigi.com/wadus</uri>
    </author>
    <entry xmlns:ptRelationship="http://schemas.partigi.com/v1.0/ptRelationship">
      <category scheme="http://schemas.partigi.com/v1.0#kind" term="http://schemas.partigi.com/v1.0#relationship"/>
      <id>http://www.partigi.com/api/v1/friendships/show.atom?source_id=wadus&target_id=tradus</id>
      <title>Friendship between wadus and tradus</title>
      <link type="application/atom+xml" rel="self" href="http://www.partigi.com/api/v1/friendships/show.atom?source_id=wadus&target_id=tradus"/>
      <updated>2009-07-08T06:54:17Z</updated>
  
      <ptRelationship:source>
        <ptUser:id>123</ptUser:id>
        <ptRelationship:following>true</ptRelationship:following>
        <ptRelationship:followed_by>false</ptRelationship:followed_by>
      </ptRelationship:source>

      <ptRelationship:target>
        <ptUser:id>321</ptUser:id>
        <ptRelationship:following>false</ptRelationship:following>
        <ptRelationship:followed_by>true</ptRelationship:followed_by>
      </ptRelationship:target>
    </entry>
  </feed>

This example response means that the user wadus is following tradus, but tradus does not follow wadus.

Go back to Partigi API Documentation