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:

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.

Steps to generate the Base Product URL and API Key

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

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

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

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
   

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.
   

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

   • 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.
   

   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
   
   or post to a mailbox.
   

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

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.
  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.
  

• 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

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.

Throttling Limits

Actions

Get 5 random quotes

Get 5 random quotes for an author

Get a random quote

Get a specified number of random quotes

Get a specified number of random quotes for a theme

Get a specified number of random quotes for an author

Get all authors

Get all themes

Get an author

Get today's quote

Gets a theme

Gets up to 5 random quotes for a theme

Definitions

VwAuthor

VwQuote

VwTheme