Canvas is simple to use, but before diving in it can be a good idea to get to you should know some of the key concepts involved.
In this article we will describe three central concepts for Canvas: apps, blocks, and workflows.
We will also describe how Canvas uses a middle layer API to interact with external APIs.
...
Tip |
---|
Summary:
|
...
In short, workflows are made up of blocks which fetch data using apps registered in the user account |
...
. API calls on Canvas are (usually) not made to the external APIs directly; instead a simplified internal API is used for each app, which forwards the request to the external API. |
Topics covered:
...
Here you see the blocks this workflow consists of:
...
About the
...
middle layer API
It is important to know that blocks on Canvas (usually) do not query external APIs directly; instead they query an internal wrapper/middle layer API which is part of Canvas' backend.
From there the requests are forwarded The middle layer API forwards requests to the external API, using the credentials from the registered application in the user account.
This simplifies and unifies the process of working with several external APIs, while ensuring secure handling of authentication.
...
It is also worth mentioning that there is a generic REST connector, which can be used to query any external REST API directly, but . But in most cases it will be preferable to use the internal API via non-generic apps with pre-made blocks if the app is supported.
...