ner0tic/foursquare-api

Foursquare API v2 client

2.0.0 2013-05-06 21:46 UTC

README

ORM agnostic php library to access foursquare api version 2.0

Installation

Add to composer

    "require": {
        "ner0tic/php-api-core":     "2.*",
        "ner0tic/foursquare-api":   "2.*"
        // ...

Usage

$fs = new \Foursquare\Client();

$checkins = $fs->api('checkins')->recent(); // recent($id,max=10)
foreach($checkins as $checkin) {
  echo $checkin; // $checkin->timestamp.' '.$checkin->getVenue()->getName()
}

Api's to choose from:

  • users
  • checkins
  • venues
  • venue groups
  • tips
  • lists
  • updates
  • photos
  • settings
  • specials
  • campaigns
  • events
  • pages
  • page updates
  • multi

To set the auth settings manually

$fs = new \Foursquare\Client();

$fs->setAuthClientId($id);
$fs->setAuthHttpPassword($pass);
$fs->setAuthUrlToken($token);
$fs->setAuthHttpToken($token);

If you have api keys to use, mash them into a pem file and set the certificate option to the path of the file.

$client->setOption('certificate', $pem_file);

Make a query

$result = $api->get($endpoint, $parameters, $request_options);

ToDo

Laundry List

  • DI to access config.yml for variables