get/view
This resource returns entry listings based on a certain view. These views correspond to the views on the homepage of Blipfoto.com.
URL
http://api.blipfoto.com/get/view/
- Version 1
- Version 2
Parameters
Note that some views may require the authentication parameters.
| Parameter | Description | Required? |
|---|---|---|
view |
The type of view to use. This can be any one of the following:
| Yes |
max |
The maximum number of entries to return. The default is 12, while the limit is 90. | No |
size |
The thumbnail size, big (124px, default) or small (48px). |
No |
color |
The thumbnail color, color (default) or gray. |
No |
test |
By default, the API does not include results from test accounts. When in the testing phase of your application, pass '1' to this parameter to include results from your test account. | No |
Response data
The data object is an array of objects containing the following:
| Name | Description | Data type |
|---|---|---|
user_name |
The contributor's username | String |
journal_name |
The contributor's journal name | String |
entry_id |
The entry's unique identifier | String |
thumbnail |
The URL of the entry's thumbnail | String |
date |
The entry date in YYYY-MM-DD format | String |
title |
The entry title | String |
permalink |
The URL of the entry | String |
Example
The following request:
http://api.blipfoto.com/get/view/?api_key=4c297fc904&view=random&max=2might result in the following response:
<?xml version="1.0" encoding="UTF-8"?>
<blipapi>
<request_id></request_id>
<error></error>
<data>
<item>
<user_name>Joe</user_name>
<journal_name>Joe Blogs</journal_name>
<entry_id>264538</entry_id>
<thumbnail>
http://www.blipfoto.com/thumbs/2/2009/big/color/205636222249b6da74c1f232
.13998171.jpeg
</thumbnail>
<date>2009-03-10</date>
<title>Repose</title>
<permalink>http://www.blipfoto.com/Joe-2009-3-10</permalink>
</item>
<item>
<user_name>Joe</user_name>
<journal_name>Joe Blogs</journal_name>
<entry_id>263889</entry_id>
<thumbnail>
http://www.blipfoto.com/thumbs/2/2009/big/color/203157200849b56b1287dc24
.87338624.jpeg
</thumbnail>
<date>2009-03-09</date>
<title>Mother</title>
<permalink>http://www.blipfoto.com/Joe-2009-3-9</permalink>
</item>
</data>
</blipapi>