DragBin Logo
DragBin
← Back to Help Center

API Documentation

Integrate DragBin's secure cloud storage into your applications with our comprehensive API.

Getting Started

DragBin's API provides programmatic access to our secure cloud storage platform. All API endpoints are protected with authentication and maintain our zero-knowledge security model.

Base URL: https://api.dragbin.com/v1/

Authentication

All API requests require authentication using API keys. You can generate API keys from your DragBin dashboard.

API Key Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Security Note: Keep your API keys secure. Never expose them in client-side code or public repositories.

Core Endpoints

Upload File

POST/files/upload

Upload an encrypted file to DragBin

curl -X POST https://api.dragbin.com/v1/files/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "encrypted=true"

List Files

GET/files

Retrieve a list of your files

curl https://api.dragbin.com/v1/files \
  -H "Authorization: Bearer YOUR_API_KEY"

Download File

GET/files/{file_id}/download

Download an encrypted file

curl https://api.dragbin.com/v1/files/abc123/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o downloaded_file.pdf

Create Share Link

POST/files/{file_id}/share

Generate a secure share link

curl -X POST https://api.dragbin.com/v1/files/abc123/share \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expires_in": 86400, "password_protected": true}'

Encryption & Security

All files uploaded through the API maintain DragBin's end-to-end encryption standards:

  • Files are encrypted client-side before transmission
  • API keys are encrypted in transit and at rest
  • All endpoints use HTTPS with TLS 1.3
  • Zero-knowledge architecture is maintained

Client-Side Encryption

When using the API, you're responsible for encrypting files before upload. We provide SDKs that handle encryption automatically.

SDKs & Libraries

We provide official SDKs for popular programming languages:

JavaScript/Node.js

npm install @dragbin/sdk

Python

pip install dragbin-python

Go

go get github.com/dragbin/go-sdk

PHP

composer require dragbin/php-sdk

Rate Limits

  • Personal Plans: 1,000 requests/hour
  • Business Plans: 10,000 requests/hour
  • Enterprise Plans: Unlimited (fair use)

Rate limit headers are included in all responses to help you manage your usage.

Response Format

All API responses are in JSON format and follow this structure:

{
  "success": true,
  "data": {
    // Response data here
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-01-15T10:30:00Z"
  }
}

Need Help with the API?

Check out our interactive API explorer or contact our developer support team.

API ExplorerDeveloper Support