Much to come including proper documentation and tests.
A developer can interact with the Hyperpublic API and this PHP library by using a number of methods on a Hyperpublic object. The available methods are show, find, and create. A Hyperpublic object can be either a person (people), a place (places), or a thing (thing).
First we need to create a connection to Hyperpublic using your API keys.
$hyperpublic = new Hyperpublic(CONSUMER_KEY,CONSUMER_SECRET);Returns a person with the ID 4.
$me = $hyperpublic->people->show(4);You can now easily access any available information about me.
This is how you get my name.
echo $me->headline; And this is how you get my tags.
foreach($me->tags as $tag) {
echo $tag;
}The following returns a search for people tagged “developer”.
$developers = $hyperpublic->people->find(array('tags' => 'developer'));We can now easily retrieve photographs of the developers.
foreach($developers as $developer){
echo "<img src='{$developer->image->src_large}'/>";
} Say we want to narrow that search to a neighborhood and return no more than 10.
$brooklynDevs = $hyperpublic->people->find(array('tags' => 'developer', 'location[neighborhood]' => 'williamsburg', 'limit' => '10'));Let’s create a place.
$myHouse = $hyperpublic->place->create(array('name' => 'my house','category' => 'home','tag_list' => '["cat","nintendo wii","coffee","brooklyn"]'));Check out example.php for more detailed examples.
Please join the Hyperpublic API mailing list for the most recent information. Further documentation may be found at http://developers.hyperpublic.com.