Skip to main content
Skip table of contents

Aviary Connector v1.0



Login to Aviary

image-20241227-092051.png

After logging in you will be directed to main dashboard.

image-20241227-092216.png

image-20240910-145040.png
image-20240910-144743.png

 

1. Authentication

API authentication method:

Authorization: /api/v1/auth/sign_in

This endpoint allows Aviary users to sign in with an API Key and, upon successful authentication, returns a JSON response containing data about the user's profile and data about each of the organizations that the user is a member of.

Creating a User API Key

In order to work with the Aviary API, users can generate an API Key. An API key, or application programming interface key, is a unique code that identifies and authenticates an application or user. To create an Aviary API Key, browse to your Aviary user profile. On the API Key section, click on the Generate/Regenerate API Key to reveal the one-time key. For security purposes, the key must be saved to a secure location and will not be revealed to you again. If you lose your key, you can simply regenerate a new API Key by clicking the same button.

image-20240910-144946.png

2. Connector Actions and Tests

 

Action Name / Method

Collections (GET)

Action Description

Allows to retrieve information about collections hosted within the Aviary platform. Specifically, it provides access to metadata and structural information about a particular collection.

 

Test Case

Retrieve collections

Request Body Name

Parameter

image-20240910-152539.png

Action Name / Method

Resources (GET)

Action Description

Use GET request to fetch resource data using an existing resource id.

 

Test Case

Retrieve collections

Request Body Name

Parameter

 

Resource Id

 

Collection Id

 

Organization Id

image-20240910-152719.png

3. Connection Settings and Configuration

image-20241227-092350.png

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.