Fan/create

From Justin.tv API Wiki

Jump to: navigation, search

Creates a new fan. This call requires OAuth authentication for the initiating user.

Interface

URL: http://api.justin.tv/api/fan/create/login.format
Formats: xml, json
Methods: POST
Authentication: Requires Authentication
Params: Must include channel login. Initiating user will be the user owning the provided OAuth tokens.
Returns: User Object

Examples

  • You try to become a fan of user "officecam", but that user is already in your favorites list
    • Action
      • url = http://api.justin.tv/api/fan/create/officecam.xml
      • method = POST
<hash>
 <url>/api/fan/create/officecam.xml</url>
 <error>Couldn't create fan relationship</error>
</hash>
  • You want to become a fan of channel "officecam", who is not already in your favorites list
    • Action
      • url = http://api.justin.tv/api/fan/create/officecam.xml
      • method = POST
<user>
 <broadcaster>true</broadcaster>
 <id>28559</id>
 <login>officecam</login>
 <name>The (Justin.tv) Office</name>
 <profile_about>This is the Justin.TV office in San Francisco.
 </profile_about>
 <favorite_quotes nil="true"></favorite_quotes>
 <location>San Francisco</location>
 <sex>Prefer not to disclose</sex>
 <profile_background_color nil="true"></profile_background_color>
 <profile_link_color nil="true"></profile_link_color>
 <profile_header_text_color nil="true"></profile_header_text_color>
 <profile_header_bg_color nil="true"></profile_header_bg_color>
 <profile_header_border_color nil="true"></profile_header_border_color>
 <profile_url>http://www.justin.tv/officecam/profile</profile_url>
 <image_url_huge>http://static-cdn.justin.tv/jtv_user_pictures/officecam-320x240-3.jpg</image_url_huge>
 <image_url_large>http://static-cdn.justin.tv/jtv_user_pictures/officecam-125x94-3.jpg</image_url_large>
 <image_url_medium>http://static-cdn.justin.tv/jtv_user_pictures/officecam-75x56-3.jpg</image_url_medium>
 <image_url_small>http://static-cdn.justin.tv/jtv_user_pictures/officecam-50x37-3.jpg</image_url_small>
 <image_url_tiny>http://static-cdn.justin.tv/jtv_user_pictures/officecam-33x25-3.jpg</image_url_tiny>
</user>
Client Libraries