Rate a Contest Entry
From ePrize Developers Wiki
| Line 14: | Line 14: | ||
|title=Rate an entry successfully: | |title=Rate an entry successfully: | ||
|summary=Demonstrates successful response | |summary=Demonstrates successful response | ||
| - | |request= | + | |request= profile: http://test.url.eprize.com/v1/solution/contestv2v2/profile/1.5J4L55FNLN2CZZDV |
| - | + | rating: 1 | |
| - | + | ||
|responsecode=200 OK | |responsecode=200 OK | ||
|response=<?xml version="1.0" encoding="UTF-8" ?> | |response=<?xml version="1.0" encoding="UTF-8" ?> | ||
Revision as of 19:13, 19 April 2011
Summary
Rate a contest entry. A rating is provided by a user and must be associated with a profile. The average rating is recomputed with each rate action.
Resource
/v1/{apikey}/contest/entry/{entryId}/rate
Valid Methods
POST
Resource Arguments
Note: resource arguments are always required.
apikey: Your API Key.
entryid: ID of the entry retrieved from entry creation or by viewing the gallery.
Parameters Required
profile: Canonical Location of a user profile. See: Fetch Profile by Key
Example: Rate an entry successfully:
Summary
Demonstrates successful response
Request
profile: http://test.url.eprize.com/v1/solution/contestv2v2/profile/1.5J4L55FNLN2CZZDV rating: 1
Response
HTTP Status Code: 200 OK
<?xml version="1.0" encoding="UTF-8" ?>
<result>
<entry>
<body>this is the body of my essay</body>
<category></category>
<city></city>
<description></description>
<entry_id></entry_id>
<entry_state>approved</entry_state>
<first_name></first_name>
<last_name></last_name>
<rating_ave>0.667</rating_ave>
<rating_count>3</rating_count>
<state></state>
<title>this is the title of my essay</title>
<views>0</views>
<votes>0</votes>
</entry>
</result>
Example: Rate a contest entry with an invalid rating
Summary
Demonstrates error response
Request
-dprofile=http://test.url.eprize.com/v1/solution/contestv2v2/profile/1.5J4L55FNLN2CZZDV \ -drating=h \ http://test.url.eprize.com/v1/solution/contestv2/contest/entry/1/rate
Response
HTTP Status Code: 400 Bad Request
<?xml version="1.0" encoding="UTF-8" ?>
<result>
<input_error>
<name>rating</name>
<error>VALIDATION</error>
</input_error>
</result>
Example: Already reached rating limit
Summary
Demonstrates unsuccessful response
Request
-dprofile=http://test.url.eprize.com/v1/solution/contestv2v2/profile/1.5J4L55FNLN2CZZDV \ -drating=1 \ http://test.url.eprize.com/v1/solution/contestv2/contest/entry/1/rate
Response
HTTP Status Code: 400 Bad Request
<?xml version="1.0" encoding="UTF-8" ?>
<result>
<input_error>
<name>rating</name>
<error>LIMITED</error>
</input_error>
</result>
Example: Rating timeout
Summary
Demonstrates unsuccessful response
Request
-dprofile=http://test.url.eprize.com/v1/solution/contestv2v2/profile/1.5J4L55FNLN2CZZDV \ -drating=1 \ http://test.url.eprize.com/v1/solution/contestv2/contest/entry/1/rate
Response
HTTP Status Code: 400 Bad Request
<?xml version="1.0" encoding="UTF-8" ?>
<result>
<input_error>
<name>profile_id</name>
<error>RATING_TIMEOUT</error>
</input_error>
</result>
Example: Rating in wrong phase:
Summary
Demonstrates unsuccessful response
Request
-dprofile=http://test.url.eprize.com/v1/solution/contestv2v2/profile/1.5J4L55FNLN2CZZDV \ -drating=1 \ http://test.url.eprize.com/v1/solution/contestv2/contest/entry/1/rate
Response
HTTP Status Code: 400 Bad Request
<?xml version="1.0" encoding="UTF-8" ?> <result> <terminal_error>OUT_OF_PHASE</terminal_error> </result>
Example: Rating non-existent entry
Summary
Demonstrates unsuccessful response
Request
-dprofile=http://test.url.eprize.com/v1/solution/contestv2v2/profile/1.5J4L55FNLN2CZZDV \ -drating=1 \ http://test.url.eprize.com/v1/solution/contestv2/contest/entry/5/rate
Response
HTTP Status Code: 404 Not Found
<?xml version="1.0" encoding="UTF-8" ?> <result> <status>0</status> </result>
