/feed/photos/user/{userId}/albumid/{albumId}
The following methods are supported on this resource:
Mount Points
The following URLs are examples of where this resource is mounted :
| XML: | http://api.hi5.com |
| *JSON: | http://api.hi5.com |
| *JSON endpoints are mounted read-only. | |
read
Retrieve photos of a given user from a given album. If the photos are set to private you must provide an authorization token and be either the target user or the friend of the target user.
Possible HTTP Parameters
| name | description |
|---|---|
| albumId | Either album id, "@all" to retrieve photos from all albums, or "@mobile" to get photos from mobile album |
| userId | (no documentation provided) |
| updatedSince | Filters out all photos before provided date. The format is yyyy-MM-dd-HH:mm. |
| lang | (no documentation provided) |
Output Payload
atom feed of photos from the specified album
Errors
| code | description |
|---|---|
| 403 | Thrown when an attempt is made to do something without the correct permissions. |
| 404 | Thrown when attempting to access a missing resource |
| 400 | Thrown when attempting to access a missing resource |
update
In order to upload photos one must post to this endpoint with multi-part attachment containing photo files. This endpoint will upload photos into specified album for a particular user. Here is an example of how a photo can be uploaded with curl command.
curl -F upload=@filename "api.hi5.com/rest/feed/photos/user/userId/albumid/albumid?Hi5AuthToken=token"
If @mobile is specified as album id, photos will go to a designated album for photos uploaded from mobile devices.
Authorization token is required. It can be obtained using the following endpoint auth/plain
Possible HTTP Parameters
| name | description |
|---|---|
| albumId | target album |
| userId | user who is uploading photos |
Input Payload
list of photos as a multi-part post
Output Payload
The updated atom feed of photos after the upload
Errors
| code | description |
|---|---|
| 403 | Thrown when an attempt is made to do something without the correct permissions. |
| 404 | Thrown when attempting to access a missing resource |
| 400 | Thrown when attempting to access a missing resource |