Blipfoto API

Breaking changes - legacy APIs will be disabled 6th January, 2014

Please note - the v1 and v2 APIs will be permanently disabled on Monday the 6th of January, 2014. If your app uses these APIs, you should migrate to v3 before this date to ensure your app continues to function correctly.

Migrating your app to v3 will require some fundamental changes, including updating resource URLs and handling the new authentication flow. You can read more about migration at the new developer site:

https://developer.blipfoto.com/docs/v3/migration

For further help with the v3 API, ask a question on the API forum or get in touch.

get/comments

This resource returns details of unread comments from the authenticated user's journal.

URL

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

Parameters

This resource also requires the API Key and Authentication parameters.

Parameter Description Required?
max The maximum number of comments to return (the default is 7, the limit is 20). No
size The thumbnail size of the entry commented on, big (124px, default) or small (48px) No
color The thumbnail color of the entry commented on, color (default) or gray No

Response data

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

Name Description Data type
content An HTML string containing the notification message. String
entry_id The unique ID of the entry that was commented on. String
display_name The display name of the author of the comment. String
time A Unix timestamp (GMT) denoting when the comment was given. Integer
thumbnail The URL of the thumbnail for the entry that was commented on. String
permalink The URL of the entry that was commented on. String

Example

The following request:

http://api.blipfoto.com/get/comments/?api_key=4c297fc904&max=1

will give this response:

<?xml version="1.0" encoding="UTF-8"?>
<blipapi>
	<version>1</version>
	<request_id></request_id>
	<error></error>
	<data>
		<comment>
			<content>
				<![CDATA[Fine looking bangers. Just begging to be sizzled!<br /><br />
Interested to know exactly <i>which </i>part of a dead pig G thinks these are...]]>
			</content>
			<entry_id>553510</entry_id>
			<display_name>red</display_name>
			<time>1273680714</time>
			<permalink>http://www.blipfoto.com/entry/553510</permalink>
			<thumbnail>http://www.blipfoto.com/thumbs/4442/2010/big/color/
11344123624bdc7793deca88.11648454.jpeg</thumbnail>
		</comment>
	</data>
</blipapi>