VitaCloud Quotes (Preview)

  • Reference

A daily dose of inspirational quotes delivered to you application or website. Choose from a variety of themes and authors.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name VitaCloud Support
URL https://www.vitacloud.co.uk
Email support@vitacloud.co.uk
Connector Metadata
Publisher VitaCloud Limited
Website https://www.vitacloud.co.uk
Privacy policy https://www.vitacloud.co.uk/PrivacyPolicy
Categories Lifestyle and Entertainment;Productivity

VitaCloud Quotes API provides a curated set of quotes by famous authors and celebrities, tagged with various themes such as faith, god, happiness, hope, humour, inspiration, knowledge, life lessons, love, motivation, philosophy, poetry, relationship, religion, romance, science, time, truth, and wisdom. VitaCloud Quotes API connector is a wrapper around the VitaCloud Quotes API that enables bringing the tailored, daily and random VitaCloud Quotes into your workspace using Microsoft Power Automate, Microsoft Power Apps, and Azure Logic Apps in your Azure and Office 365 subscription.

Prerequisites

You will need the following to proceed:

  • A VitaCloud API Base URL
  • A VitaCloud API Key
  • A Microsoft Power Apps or Power Automate plan with custom connector feature

How to get credentials

This video walks through the process of subscribing to the VitaCloud Quotes APIs and retrieving the sibscription keys and the Base URL require to integrate the APIs in your products and in the official Office 365 connector and web parts.

VitaCloud Quotes API Signup

Steps to generate the Base Product URL and API Key

  1. Sign up or log in to the VitaCloud API Portal
    Portal home

  2. Subscribe to one of the free or paid products from the Product catalog
    Product catalog

  3. Select the subscribed product in the portal and copy the Base Product URL
    Select subscribed product

  4. Click the Profile menu and in the Subscriptions section, select the same product, click the Show button for the primary or secondary key and copy it. This is your API Key
    Authentication

The Base Product URL and API Key will be required for connecting to the Quotes connector in Power Automate and Power Apps.

Get started with the VitaCloud Quotes connector

  1. Select an action from the VitaCloud Quotes connector in Power Automate.
    select action

  2. If using the connector for the first time, you will be prompted to provide the following details to create a connection.
    select action

    • Connection name. Give a unique name for your connection. E.g. VitaCloud Quotes
    • Base Product URL. See video and steps to generate the API Base URL in the above section.
    • API Key. See video and steps to generate the API Key in the above section.

  3. Provide any parameters for the selected action, if prompted.
    select action

    Get Authors and Get Themes actions can be used to get the available authorTags and themeTags.

  4. Consume the output in downstream actions, such as compose and post an adaptive card to a Team's channel or Group chat
    select action select action
    or post to a mailbox.
    select action

  5. The connector can also be used in Power Apps.
    select action

Known issues and limitations

  • Please note some functionality may be limited based on the subscribed product. E.g. if only VitaCloud Free Quotes product is subscribed, then only the Get Today's Quote and Get Random Quote actions will work in the connector.
  • We recommend subscribing to the VitaCloud Quotes Premium or VitaCloud Quotes Ultimate product based on your call quota limits to unlock all options in the connector.
  • If number of quotes is not specified for operations requiring them, then at most 5 quotes will be returned in the response.
  • Number of quotes returned will be limited to a maximum of 10.
  • Some authors may not have a corresponding Wikipedia link.
  • Author images are subject to change, but will maintain the same size and aspect ratio.

Common errors and remedies

  • If an incorrect Base Product URL or API Key is specified, HTTP status code 404 - not found will be returned, alongwith a response as below
    {"requestId": long string, "message": "No data product found. Please contact your data provider"}
    Please update the connection with the correct Base Product URL and API Key from the API portal. Please see the above video.

  • If an action is used that is not included in the product corresponding to the Base Product URL, HTTP status code 403 - forbidden will be returned, alongwith a response as below
    {"requestId": long string, "message": "Endpoint not available"}
    Update the connection with the Base Product URL corresponding to the product containing the requested endpoint.

FAQ

  • How can I consume the APIs directly in a website or app?
    Download the OpenAPI 3.0 specification for your subscribed API on the API tab for your product.
    Authentication Please include the API key in the header for your request to the endpoints. Select an endpoint in the API tab to try out a request in the portal.

  • What themes and authors are included? The Quotes connector Get Themes action provides over 20 themes to choose from, including popular ones like humour, wisdom, science, inspiration, philosophy and happiness. The Get Authors action provides details for over 700 authors, personalities and celebrities. Most endpoints also include authors' images and wikipedia links, where available.
    authors themes authors

  • Where can I reach out if I have a product query or require support?
    Please send your query to VitaCloud Support or fill out the contact form on the VitaCloud Website.

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Base Product URL string https://apis.vitacloud.co.uk or https://apis.vitacloud.co.uk/free True
API Key securestring Your subscription Key True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get 5 random quotes

Sample request: GET /Quotes
Get 5 random quotes for an author

Sample request: GET /Quotes/Author/aamilne,mahatmagandhi
Get a random quote

Sample request: GET /Quotes/random
Get a specified number of random quotes

Sample request: GET /Quotes
Get a specified number of random quotes for a theme

Sample request: GET /Quotes/Theme/love,inspiration/5
Get a specified number of random quotes for an author

Sample request: GET /Quotes/Author/aamilne/5
Get all authors

Sample request: GET /Authors
Get all themes

Sample request: GET /Themes
Get an author

Sample request: GET /Authors/aamilne
Get today's quote

Sample request: GET /Quotes/today
Gets a theme

Sample request: GET /Themes/happiness
Gets up to 5 random quotes for a theme

Sample request: GET /Quotes/Theme/love Or GET /Quotes/Theme/love,inspiration

Get 5 random quotes

Operation ID:
GetRandomQuotes

Sample request: GET /Quotes

Returns

response
array of VwQuote

Get 5 random quotes for an author

Operation ID:
GetRandomQuotesByAuthor

Sample request: GET /Quotes/Author/aamilne,mahatmagandhi

Parameters

Name Key Required Type Description
Author Tag
 authortag True string

Author's tag or a comma separated list of author tags

Returns

response
array of VwQuote

Get a random quote

Operation ID:
GetRandomQuote

Sample request: GET /Quotes/random

Returns

Quote
VwQuote

Get a specified number of random quotes

Operation ID:
GetRandomQuotesByNum

Sample request: GET /Quotes

Parameters

Name Key Required Type Description
Number of quotes (max 10)
 number True integer

Number of random quotes to return (max 10)

Returns

response
array of VwQuote

Get a specified number of random quotes for a theme

Operation ID:
GetRandomQuotesByThemeAndNum

Sample request: GET /Quotes/Theme/love,inspiration/5

Parameters

Name Key Required Type Description
Theme Tag
 themetag True string

Theme tag or a comma separated list of them tags.
Number of quotes (max 10)
 number True integer

Number of random quotes to return (max 10)

Returns

response
array of VwQuote

Get a specified number of random quotes for an author

Operation ID:
GetRandomQuotesByAuthorAndNum

Sample request: GET /Quotes/Author/aamilne/5

Parameters

Name Key Required Type Description
Author Tag
 authortag True string

Author's tag or a comma separated list of author tags
Number of quotes (max 10)
 number True integer

Number of random quotes to return (max 10)

Returns

response
array of VwQuote

Get all authors

Operation ID:
GetAuthors

Sample request: GET /Authors

Returns

response
array of VwAuthor

Get all themes

Operation ID:
GetThemes

Sample request: GET /Themes

Returns

response
array of VwTheme

Get an author

Operation ID:
GetAuthor

Sample request: GET /Authors/aamilne

Parameters

Name Key Required Type Description
Author Tag
 authortag True string

Author tag. For a list of available author tags, use the Get all authors action

Returns

Author
VwAuthor

Get today's quote

Operation ID:
GetTodaysQuote

Sample request: GET /Quotes/today

Returns

Quote
VwQuote

Gets a theme

Operation ID:
GetTheme

Sample request: GET /Themes/happiness

Parameters

Name Key Required Type Description
Theme Tag
 themetag True string

Theme tag. For a list of available theme tags, use the Get all themes action

Returns

Theme
VwTheme

Gets up to 5 random quotes for a theme

Operation ID:
GetRandomQuotesByTheme

Sample request: GET /Quotes/Theme/love Or GET /Quotes/Theme/love,inspiration

Parameters

Name Key Required Type Description
Theme Tag
 themetag True string

Theme tag or a comma separated list of them tags

Returns

response
array of VwQuote

Definitions

VwAuthor

Name Path Type Description
Tag
 AuthorTag string

Author's Tag
Name
 AuthorName string

Author's Name
Image
 AuthorImage string

Author's Image
Link
 AuthorLink string

Author's Wikipedia Link

VwQuote

Name Path Type Description
Author Tag
 AuthorTag string

Author's Tag
Author Name
 AuthorName string

Author's Name
Author Image
 AuthorImage string

Author's Image
Author Link
 AuthorLink string

Author's Wikipedia Link
Text
 Quote string

Quote Text
Length
 Length integer

Quote Length
Theme Tag
 ThemeTag string

Theme tag
Theme Name
 ThemeName string

Theme Name

VwTheme

Name Path Type Description
Tag
 ThemeTag string

Theme tag
Name
 ThemeName string

Theme Name
Number of quotes
 ThemeQuotes integer

Number of quotes