Smart Builder SDK allows us to fetch data from 3rd party APIs that require OAuth authentication. Combined with Apps Authentication we take care of the auth token for you and all you need to worry about is making the API calls using a useful hook: useApiRequest.

Here are some important notes about this hook:

• It is exported from import { useApiRequest } from 'smart-builder-sdk'.
• It requires a credentialId as a unique parameter, received from theuseAppOauth hook that we saw in Apps Authentication.
• It manages token validation; in case of an error, a friendly error message will appear.

How to use the useApiRequest hook

Make an API call - like this useApiRequest(myCredentialId) - and this returns an object with the following methods:

• get
• patch
• post
• put
• delete

So, let’s put this hook together with the useAppOauth hook.

Here is a very bare-bones example:

import { useAppOauth, useApiRequest } from 'smart-builder-sdk'

import { manifest } from './my-manifest'

const MY_API = '<https://my-example-api.com/api>';
const { credentialsId } = useAppOauth(manifest.appId);
const { get } = useApiRequest(credentialsId);
// Executes the call
const { data } = await get(`${ MY_API }/list`)