Direct API

A direct pass-through API for native communications with underlying provider APIs using Aurinko's unified OAuth flow.

Aurinko /direct API

The Aurinko /direct API endpoint enables applications to request native provider payloads directly, leveraging Aurinko's OAuth Flow and secure access token storage. It is a valuable alternative to data unification, offering flexibility and control for complex integrations while still benefiting from Aurinko's core security and authentication features.

The Aurinko /direct API offers significant advantages in specific scenarios:

• Circumventing Data Unification: When data unification isn't necessary or feasible (due to complexity or specific integration requirements), the /direct API allows for direct interaction with the provider's native API. This provides the flexibility needed for intricate or unique integrations.

• Debugging and Troubleshooting: The /direct API serves as an invaluable tool for debugging and troubleshooting. By directly interacting with the provider's API within the context of Aurinko's authentication framework, developers can isolate and pinpoint issues related to specific API calls or provider responses.

• Leveraging Aurinko's Authentication: While bypassing data unification, the /direct API still leverages Aurinko's robust authentication and authorization mechanisms. This ensures secure and controlled access to provider APIs, maintaining a consistent security posture across all integrations.

Examples

Gmail API

Get a list of Gmail messages for a Gmail Aurinko account:

curl -X GET -H 'Authorization: Bearer <access token>' \
    -G https://api.aurinko.io/v1/direct/gmail/v1/users/me/messages

/gmail/v1/users/me/messages is the path of the Gmail API endpoint.

Graph API

Geta list of Office 365 messages for an Office 365 Aurinko account:

curl -X GET -H 'Authorization: Bearer <access token>' \
    -G https://api.aurinko.io/v1/direct/me/messages

/me/messages is the path of the Graph API endpoint. Salesforce API

Get a description of a Salesforce Contact object for a Salesforce Aurinko account:

curl -X GET -H 'Authorization: Bearer <access token>' \
    -G https://api.aurinko.io/v1/direct/services/data/v51.0/sobjects/Contact/describe/

/sobjects/Contact/describe/ is the path of the Salesforce API endpoint.