REST API Documentation
/gallery/reviews
Create a review
For requests using an OAuth Access Token for a particular member, any parameters the user doesn't have permission to use are ignored (for example, hidden will only be honoured if the authenticated user has permission to hide content).
Parameters
Name | Type | Description |
---|---|---|
Required
image
|
int | The ID number of the image the review is for |
Required
author
|
int | The ID number of the member making the review (0 for guest). Required for requests made using an API Key or the Client Credentials Grant Type. For requests using an OAuth Access Token for a particular member, that member will always be the author |
Required
content
|
string | The review content as HTML (e.g. "<p>This is a review.</p>"). Will be sanatized for requests using an OAuth Access Token for a particular member; will be saved unaltered for requests made using an API Key or the Client Credentials Grant Type. |
Required
rating
|
int | Star rating |
author_name
|
string | If author is 0, the guest name that should be used |
date
|
datetime | The date/time that should be used for the review date. If not provided, will use the current date/time. Ignored for requests using an OAuth Access Token for a particular member |
ip_address
|
string | The IP address that should be stored for the review. If not provided, will use the IP address from the API request. Ignored for requests using an OAuth Access Token for a particular member |
hidden
|
int | 0 = unhidden; 1 = hidden, pending moderator approval; -1 = hidden (as if hidden by a moderator) |
anonymous
|
bool | If 1, the item will be posted anonymously. |
Exceptions
Code | Message | Description |
---|---|---|
2G318/8 |
INVALID_ID |
The forum ID does not exist |
1G318/3 |
NO_AUTHOR |
The author ID does not exist |
1L298/4 |
NO_CONTENT |
No content was supplied |
1G318/5 |
INVALID_RATING |
The rating is not a valid number up to the maximum rating |
2G318/D |
NO_PERMISSION |
The authorized user does not have permission to review that image |
Response
Name | Type | Description |
---|---|---|
id
|
int | ID number |
item
|
int | The ID number of the item this belongs to |
author
|
member object | Author |
date
|
datetime | Date |
rating
|
int | The number of stars this review gave |
votesTotal
|
int | The number of users that have voted if this review was helpful or unhelpful |
votesHelpful
|
int | The number of users that voted helpful |
content
|
string | The content |
hidden
|
bool | Is hidden? |
url
|
string | URL to content |
authorResponse
|
string|NULL | The content item's author's response to the review, if any |
member
object
Name | Type | Description |
---|---|---|
id
|
int | ID number |
name
|
string | Username |
title
|
string | Member title |
timezone
|
string | Member timezone |
formattedName
|
string | Username with group formatting |
primaryGroup
|
group object | Primary group |
secondaryGroups
|
array of group objects | Secondary groups |
email
|
string | Email address |
joined
|
datetime | Registration date |
registrationIpAddress
|
string | IP address when registered |
warningPoints
|
int | Number of active warning points |
reputationPoints
|
int | Number of reputation points |
photoUrl
|
string | URL to photo (which will be the site's default if they haven't set one) |
photoUrlIsDefault
|
bool | Indicates if the value of photoUrl is the site's default |
coverPhotoUrl
|
string | URL to profile cover photo (will be blank if there isn't one) |
profileUrl
|
string|null | URL to profile |
validating
|
bool | Whether or not the validating flag is set on the member account |
posts
|
int | Number of content item submissions member has made |
lastActivity
|
datetime|null | Last activity date on the site. |
lastVisit
|
datetime|null | Last distinct visit date on the site. |
lastPost
|
datetime|null | Latest content submission date. |
profileViews
|
int | Number of times member's profile has been viewed |
birthday
|
string | Member birthday in MM/DD/YYYY format (or MM/DD format if no year has been supplied). |
customFields
|
array of fieldgroup objects | Custom profile fields. For requests using an OAuth Access Token for a particular member, only fields the authorized user can view will be included |
rank
|
array of rank objects | Rank |
achievements_points
|
int | Points |
allowAdminEmails
|
bool | Whether or not this member wants to receive admin emails |
completed
|
bool | Whether or not the registration is completed |