Cloud Integration
API endpoints for cloud storage integration and OAuth
Cloud Integration API
The Cloud Integration API allows you to connect to various cloud storage providers, test connections, and manage OAuth authentication flows.
List Cloud Providers
List all supported cloud providers with OAuth support status.
Response
Returns a list of supported cloud storage providers and their OAuth support status.
Test Cloud Connection
Test connection to a cloud provider without downloading files.
Request Body
| Parameter | Type | Description | Default |
|---|---|---|---|
| provider | string | Cloud provider (gdrive, dropbox, onedrive, s3, azure, gdocs, web, excel) | Required |
| access_token | string | Access token for the cloud provider | Required |
| refresh_token | string | Refresh token (if applicable) | null |
| token_expiry | string | Token expiry timestamp | null |
| folder_path | string | Path to folder in cloud storage | null |
Response
Returns a status object with information about the cloud connection test.
Connect Cloud OAuth
Connect to a cloud provider using OAuth tokens obtained from the OAuth flow.
Request Body
A JSON object containing connection data including tokens and provider information.
Response
Returns a status object with information about the cloud connection.
OAuth Authorization
Start OAuth authorization process for a cloud provider.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| provider | string | Cloud provider to authorize |
Response
Returns authorization URL or initiates the OAuth flow.
OAuth Callback
Handle OAuth callback from cloud provider.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| code | string | Authorization code from provider |
| state | string | State parameter for security verification |
| error | string | Error message (if any) |
| error_description | string | Error description (if any) |
Response
Returns OAuth tokens or error information.
Serve OAuth Demo
Serve the OAuth demo page for testing cloud provider connections.
Response
Returns an HTML page for testing OAuth connections.
Serve OAuth Callback Page
Serve the OAuth callback page used in the authentication flow.
Response
Returns an HTML page for handling OAuth callbacks.