post/entry
This resource handles the addition of new entries to a contributor's journal. It can handle both the image and textual parts of the upload process, or it can accept text data only and use a previously uploaded image.
URL
http://api.blipfoto.com/post/entry/
Parameters
This resource requires the API Key and Authentication parameters.
POST data
| Parameter | Description | Required? | ||||||
|---|---|---|---|---|---|---|---|---|
image_upload |
The image to upload. Note that the maximum allowed filesize of the uploaded image may depend on the status of the authenticated contributor. | No | ||||||
image_url |
If the image is available publicly over HTTP, you may pass the image URL instead of directly uploading the image data. The API will then fetch the image at the URL. | No | ||||||
use_previous_image |
To use the contributor's most recently uploaded image, set this parameter to 1. This might happen after an image was uploaded successfully but there was a problem with the entry data, or if the post/image resource was used to create a 2-step upload process.If an image is supplied to the image_upload parameter, this parameter is ignored.
|
No | ||||||
transform |
Use this parameter to edit the image once it has been uploaded. Declare transforms in sequence by seperating them with commas; seperate transforms and their values with colons. Note that images are automatically oriented according to the EXIF "orientation" flag; supplying the transform parameter suppresses this behaviour, and applies transforms to the un-oriented image. |
No | ||||||
|
||||||||
title |
The title of the entry. If omitted, any IPTC Headline information within the image is used instead. | No | ||||||
description |
The description of the entry. The description may contain the following custom tags:[b]...[/b], [u]...[/u], [i]...[/i], [url=...]...[/url]. If omitted, any IPTC Description information within the image is used instead. |
No | ||||||
tags |
A comma separated list of tags to assign to the entry. If omitted, any IPTC Keywords information within the image is used instead. | No | ||||||
date |
The entry date in YYYY-MM-DD format. If omitted, the EXIF Date within the image is used instead. | No | ||||||
Response data
| Name | Description | Data type |
|---|---|---|
entry_id |
The unique identifier for the new entry. | String |
result |
A message describing the status of the entry. This must always be displayed to the user, as it may contain a moderation or other message. | String |