Blipfoto API

get/notifications

This resource returns the most recent notifications sent to the user. Note that returned notifications are marked as read after the response is sent.

URL

http://api.blipfoto.com/get/notifications/

Parameters

This resource also requires the API Key and Authentication parameters.

Parameter Description Required?
max The maximum number of notifications to return (the default is 7, the limit is 20). No

Response data

The data object contains an array of notification items, each containing the following:

Name Description Data type
icon An HTML string containing an icon (possibly inside a link) refering to the notification sender. String
content An HTML string containing the notification message. String
unread A number (0=false, 1=true) denoting if the notification is unread. If true, the user should be given a graphical clue that the notification is unread. String
time A Unix-formatted timestamp (GMT) denoting when the notification was sent. Integer

Example

The following request:

http://api.blipfoto.com/get/notifications/?api_key=4c297fc904&max=2

will give this response:

<?xml version="1.0" encoding="UTF-8"?>
<blipapi>
	<request_id></request_id>
	<error></error>
	<data>
		<notification>
			<icon>
				<![CDATA[<a href='http://www.blipfoto.com/view.php?id=376786'>
<img src='http://www.blipfoto.com/thumbs/2545/2009/small/color/10692911074ac3f6d3e35b45.
47337572.jpeg' /></a>]]>
			</icon>
			<unread>1</unread>
			<time>1254748662</time>
			<content>
				<![CDATA[<img src='http://www.blipfoto.com/gfx/icons/icon_blipof
theweek.gif' /> <a href='http://www.blipfoto.com/robotography'>robotography
</a>'s entry for <a href='http://www.blipfoto.com/view.php?id=376786'>30
September</a> was awarded Blip Of The Week]]>
			</content>
		</notification>
		<notification>
			<icon>
				<![CDATA[<a href='http://www.blipfoto.com/view.php?id=379266'>
<img src='http://www.blipfoto.com/thumbs/6494/2009/small/color/21447973424ac9dca91ef053.
30096750.jpeg' /></a>]]>
			</icon>
			<unread>0</unread>
			<time>1254743466</time>
			<content>
				<![CDATA[<a href='http://www.blipfoto.com/icons.php'>
	<img src='http://www.blipfoto.com/gfx/levels/birthday.gif' /></a>
<a href='http://www.blipfoto.com/Lahdeaho'>Lahdeaho</a> posted their 100th
<a href='http://www.blipfoto.com/view.php?id=379266'> entry</a>]]>
			</content>
		</notification>
		...
	</data>
</blipapi>

Note that some fields may not be populated due to user preferences.