Share via


VitaCloud Quotes (Preview)

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

Sample request: GET /Quotes

Returns

response
array of VwQuote

Get 5 random quotes for an author

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

Sample request: GET /Quotes/random

Returns

Quote
VwQuote

Get a specified number of random quotes

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

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

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

Sample request: GET /Authors

Returns

Get all themes

Sample request: GET /Themes

Returns

response
array of VwTheme

Get an author

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

Sample request: GET /Quotes/today

Returns

Quote
VwQuote

Gets a theme

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

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