REST API direct integration
If you're new to Composer or REST APIs, check out Primer: Integrations and REST You can also view the videos in Core Lessons 3 - Data and Integrations
Please note that REST API direction integration makes client side requests when configuring authorization credentials such as authentication headers or API keys. Learn more in Primer: Security The client side requests may also run into CORS issues in some cases, you can find a good explanation in for example https://blog.container-solutions.com/a-guide-to-solving-those-mystifying-cors-issues
A REST API direct integration type data resource essentially tells Composer how a specific, JSON-format HTTP REST API can be accessed. It defines things like a base URL, headers, query parameters, available methods, schemas and so on.
You can create new external data resources and edit existing ones via the Data button in the top toolbar.
Prepackaged external data resource configurations are called connectors, and can be installed into your app via the Marketplace.
The resource configuration is split into base configuration and method configurations for GET collection, GET record, POST, PUT/PATCH and DELETE.
Here, you define the main configuration
This is the unique ID for the resource in your app. Good convention is to have the ID be camel case with an initial capital letter, e.g. SalesforceLeads.
This is the base URL shared between all methods. For example, if the path to getting a single Salesforce lead would be https://api.salesforce.com/v2/leads/1234, where 1234 is the lead ID, your base URL would be https://api.salesforce.com/v2/leads/.
Base URL should always be configured with a trailing slash.
Path variables are used to make parts of the URL dynamic. A path variable must always be linked to the base URL by including it inside curly braces at the appropriate place in the URL.
For example, to make the v2 part of the Salesforce API URL above dynamic, you would change the base URL to https://api.salesforce.com/{apiVersion}/leads and then add a path variable apiVersion .
Path variables are always dynamic – if you wanted to set a static path variable, you should just write the value in the URL itself.
HTTP headers to be included in every API call made to this external resource.
Query parameters to be included in every API call made to this external resource.
You can configure each method for your RESTful resource separately. Switch between methods via the left panel.
Initially, all methods are disabled. To enable a method, toggle the switch near the upper-right corner of the screen.
This is the relative part of the URL for the current method that will be appended to the base URL when the method is called.
For example, for a traditional RESTful resource, the relative path for a GET record method would be just the record ID as a path variable, i.e. {id}.
The JSON response from an API might include the actual data we are interested in inside a sub-key of the main response object. Response key defines this sub-key as a dot-separated path.
For example, if our JSON response for a Salesforce lead was something like:
{"data": {"lead": {// actual lead data here}}}
We would then define our response key to be data.lead.
Path variables work just like in the base configuration, they just target the Relative path instead of the Base URL.
For example, the GET record method would likely have a id path variable.
Extra HTTP headers to be included whenever the current method is called.
Extra query parameters to be included whenever the current method is called.
For example, a search or limit query parameter would only make sense when configured exclusively for the GET collection method
Methods can be tested via the Test tab.
After getting a successful response, you can auto-detect and set the method schema from the response with the Set schema from response button.
The Schema tab lets you configure schemas for the specific method.
You can publish a data resource configuration in the Marketplace, which enables you to install it into other apps. In the data configurator, click the three-dot icon on the far right side of the data resource list item and select Publish in Marketplace.
To install the data resource in another app, simply search for it via the Marketplace, making sure to select the Data tab first.
