Check-in

POST /checkins

A Check-in is the first action users take on a Game to let others know they are watching. Enables the ability to post a Message and share an award information as well, if an award is achieved.

Award node in the response will be included if an award was achieved by the check-in

Parameters

• game_id – (required) Fanvibe or NBA id
• id_type – (optional) specify NBA if this is an NBA id
• team_pick – (optional) 0 = no pick, 1 = away team, 2 = home team
• auto_share – (optional, default false) set to true if you want to automatically share this check-in without prompting to ask if the user wants to automatically share this check-in. This will only auto share if the user has also previously set their account up to auto share, otherwise this is ignored.
• lat – (optional) Pair with a lng to unlock awards that are geo based
• lng – (optional) Pair with a lat to unlock awards that are geo based

Example

Create a Check-in for the currently authenticated User like this:

$ curl -d "game_id=176158" 'http://fanvibe.com/api/checkins.xml'    
<?xml version="1.0" encoding="UTF-8"?>
<checkin>
  <id>37285</id>
  <points>1</points>
  <created_at>2010-10-13T15:16:37-07:00</created_at>
  <auto_shared>true</auto_shared>
  <lat>26.1190294025</lat>
  <lng>-80.2548064083333</lng>
  <user>
    <id>1</id>
    <first_name>Arthur</first_name>
    <last_name>Chang</last_name>
    <profile_link>http://fanvibe.com/users/art</profile_link>
    <points>926</points>
    <facebook_user>true</facebook_user>
    <twitter_user>true</twitter_user>
  </user>
  <share>
    <message>I'm watching #Falcons vs #jaguars on Fanvibe!</message>
    <link>http://fanvibe.com/games/176158?uid=1</link>
    <name>Falcons vs Jaguars</name>
    <caption>Game finished</caption>
    <description>Check-in to Falcons vs Jaguars on Fanvibe! Checking into the game on Fanvibe will give you game updates automatically and help you follow this game and others with your friends!</description>
    <image>http://s3.amazonaws.com/fanpulse_team_logos_production/logos/3248/medium.png?1261007735</image>
  </share>
  <award>
    <id>1</id>
    <name>Special Offer!</name>
    <share>
      <message>I just earned a Special Offer Award on FanPulse!</message>
      <link>http://fanvibe.com/users/art?ref=true</link>
      <name>Special Offer!</name>
      <caption>Get this award on Fanvibe!</caption>
      <description>You have just earned a 15% discount to the Fanvibe store!</description>
      <image>http://s3.amazonaws.com/fanpulse_awards_production/images/1/large.png?1269568054</image>
    </share>
  </award>
</checkin>