/vercel-integration-ui

The UI for installing the OrderCloud integration in Vercel's integration marketplace

Primary LanguageTypeScriptMIT LicenseMIT

OrderCloud to Vercel Integration

View this integration and install it at https://vercel.com/integrations/ordercloud

Run this example

  1. Create a new integration on the integration console

  2. Set the Redirect URL to http://localhost:3000/callback

  3. Set the environment variables:

cp .env.local.example .env.local

Set the CLIENT_ID and CLIENT_SECRET accordingly to the values you see in the integration console if you edit your integration.

  1. Install all dependencies
npm install
  1. Start the app
npm run dev
  1. Add it to a project

Now your example integration is running on http://localhost:3000. Click on "View in Marketplace" to see your integration with all details like others will see it. You're now able to add your integration to a project. Once you click "add" you see a popup that will use the defined Redirect URL http://localhost:3000/callback. The integration is now installed.

How this integration works

  1. The user clicks "add" and selects the scope
  2. The user sees the callback popup with your defined Redirect URL
  3. The Redirect URL will be called with query parameters that we can use:
    • code: The authorization code to receive an access_token in order to interact with the API
    • teamId: The id of the team (only provided if the integration gets installed on a team)
    • configurationId: The id of the installation (you usually want to store this information)
    • next: The URL we're redirecting if the setup is done
  4. Once the user sees the page /setup we exchange the provided code for an access_token. See the docs for exchanging code for an access token
  5. After the code was exchanged, we can use the access_token for our calls to the Vercel API. See the docs for available endpoints. In this case we're querying the Projects endpoint to get a list of all projects for the user or the team
  6. The user sees a list of projects. This would be the step to provide additional information and allow the user to link projects to your own resources.
  7. The user clicks on "Redirect me back to Vercel" to close the popup and complete the installation on Vercel. In your real integration, this should be done automatically after you collected all information you need, to save the user some clicks.