Developer Guide

Authentication

Use only the API key. The platform derives your account from the key — no need to pass studioId or driveId in requests. Use apiKey (Client Gallery) or driveApiKey (Drive). Your Studio ID and Drive ID are shown in the dashboard for reference.

x-api-key: sk_your_api_key_here

{
  "email": "studio@example.com",
  "password": "your-password",
  "displayName": "My Studio",
  "accountType": "studio"  // or "drive"
}

// Response: { studioId, driveId, apiKey, driveApiKey, ... }
// - apiKey: use for Client Gallery API
// - driveApiKey: use for Drive API

Manage collections, upload files, and share client galleries. Send apiKey in the x-api-key header — no Studio ID in the request.

{
  "name": "Wedding 2024",
  "clientName": "John Doe",
  "date": "2024-06-15",
  "categoryId": "cat_xxx"
}

{
  "name": "General"
}

FormData: collectionId, clientName, file

File storage with folders. Send driveApiKey in the x-api-key header — no Drive ID in the request.

{
  "name": "My Folder",
  "parentId": null
}

FormData: folderId (optional), file

{
  "name": "New name",
  "targetFolderId": "folder_id"
}

{
  "fileIds": [],
  "folderIds": []
}

{
  "fileIds": [],
  "folderIds": []
}

Examples

cURL - List Drive files

curl -H "x-api-key: YOUR_DRIVE_API_KEY" \
  "https://your-platform.com/api/drive"

cURL - Upload to Drive

curl -X POST "https://your-platform.com/api/drive/upload" \
  -H "x-api-key: YOUR_DRIVE_API_KEY" \
  -F "folderId=FOLDER_ID" \
  -F "file=@/path/to/image.jpg"

JavaScript - Create collection (Client Gallery)

const res = await fetch('https://your-platform.com/api/collections', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_CLIENT_GALLERY_API_KEY'
  },
  body: JSON.stringify({
    name: 'Wedding Album',
    clientName: 'Jane Smith',
    date: '2024-06-15',
    categoryId: 'cat_xxx'
  })
});
const collection = await res.json();

JavaScript - Upload to collection

const formData = new FormData();
formData.append('collectionId', collection.id);
formData.append('clientName', 'Jane Smith');
formData.append('file', fileInput.files[0]);

await fetch('https://your-platform.com/api/upload', {
  method: 'POST',
  headers: { 'x-api-key': 'YOUR_CLIENT_GALLERY_API_KEY' },
  body: formData
});