GET_quotes_random.md

Quotes Resources

GET quotes/random

Description

Returns information about quotes for a given page and a given pagesize. Quotes are ordered by random.

Requires authentication

• A valid access token must be provided in access_token parameter.

The access_token should be sent using an HTTP header like so:

 Authorization: Bearer access_token

An example call with CURL:

 curl --header "Authorization: Bearer ZllAle9NZ11FkMyX5xm0evswWOTinrr5I26uLcGB" https://api.teen-quotes.com/v1/quotes/random

Parameters

All parameters are optional. If you don't provide these parameters the default values will be used:

• page - The page number starting from 1 to +infinity. If not specified, the default value is 1.
• pagesize - The number of quotes per page. If not specified, the default value is 10.

Example request:

GET https://api.teen-quotes.com/v1/quotes/random?page=2&pagesize=10

Return format

A JSON object containing keys quotes where quotes is a list of Quote object in full format with their author is small author.

Quote object:

• id - ID of the quote.
• content - Body of the quote
• user_id - ID of the author of the quote.
• approved - Tells the state of the quote. Since we are showing published quotes, approved will always be 1.
• created_at - Date telling when the quote was submitted.
• tags_list - An array of tags associated with the quote.
• has_comments - Tells if a quote has comments.
• total_comments - The number of comments for the quote.
• is_favorite - Tells if the quote in the favorite quotes of the user.

User object:

• id - ID of the user.
• login - Login of the user.
• profile_hidden - Tells if the profile of the user should be hidden.
• url_avatar - Full URL of the user's avatar.
• wants_notification_comment_quote - Tells if the user wants to be notified when a comment on one of its quotes.
• is_admin - True if the user is an administrator.

Additional keys:

• total_quotes - The total number of published quotes.
• total_pages - The total number of pages with the given pagesize.
• page - The number of the current page.
• pagesize - The number of quotes to display per page.
• url - URL of the current page.
• has_next_page - True if we can hit a next page of quotes.
• next_page - Displayed if has_next_page is true. The URL to hit if we want the next page of quotes.
• has_previous_page - True if we can hit a previous page of quotes.
• previous_page - Displayed if has_previous_page is true. The URL to hit if we want the previous page of quotes.

Errors

All known errors cause the resource to return HTTP error code header together with a JSON array containing at least status and error keys describing the source of error.

• 404 Not Found — No quotes have been found for this page and this pagesize.

Example

Request

GET https://api.teen-quotes.com/v1/quotes/random?page=2&pagesize=2

Success

Return

{
   "quotes":[
      {
         "id":624,
         "content":"Ut praesentium voluptatem ad amet explicabo nisi impedit autem. Laborum error quia quisquam culpa. Cupiditate molestiae aut autem quis expedita. Nemo natus consequatur exercitationem magni repellendus a ut. Impedit nesciunt velit quasi.",
         "user_id":53,
         "approved":1,
         "created_at":"2013-08-15 07:00:38",
         "tags_list": [
           "autb",
           "impeditb"
         ],
         "has_comments":true,
         "total_comments":2,
         "is_favorite":false,
         "total_favorites":10,
         "user":{
            "id":53,
            "login":"dsjje32",
            "profile_hidden":false,
            "url_avatar":"http:\/\/placekitten.com\/400\/400",
            "wants_notification_comment_quote":false,
            "is_admin":false
         }
      },
      {
         "id":594,
         "content":"Quo ab dolores qui numquam est. Id a aut distinctio possimus dolor eum repellendus. Libero aut sapiente non cupiditate cumque et architecto. Nihil aut vitae nihil odio corporis et repellendus.",
         "user_id":89,
         "approved":1,
         "created_at":"2013-07-16 07:00:38",
         "tags_list": [
           "autb"
         ],
         "has_comments":true,
         "total_comments":4,
         "is_favorite":false,
         "total_favorites":10,
         "user":{
            "id":89,
            "login":"derrl26",
            "profile_hidden":false,
            "url_avatar":"http:\/\/placekitten.com\/400\/400",
            "wants_notification_comment_quote":false,
            "is_admin":false
         }
      }
   ],
   "total_quotes":601,
   "total_pages":301,
   "page":2,
   "pagesize":2,
   "url":"https:\/\/api.teen-quotes.com\/v1\/quotes\/random",
   "has_next_page":true,
   "next_page":"https:\/\/api.teen-quotes.com\/v1\/quotes\/random?page=3&pagesize=2",
   "has_previous_page":true,
   "previous_page":"https:\/\/api.teen-quotes.com\/v1\/quotes\/random?page=1&pagesize=2"
}

Error

For an error with HTTP code 404:

{
   "status":404,
   "error":"No quotes have been found."
}