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.

Blipfoto API

get/notifications

URL

Parameters

Response data

Example