Интеграция Dropbox API с сайтом

Интеграция Dropbox API с сайтом

Dropbox API позволяет загружать и скачивать файлы, управлять папками, создавать общие ссылки. Используется как файловый бэкенд для сайтов: загрузка пользовательских файлов в Dropbox, доступ к медиатеке, бэкапы.

Аутентификация

import { Dropbox } from 'dropbox';

// Для серверных операций: App-level token
const dbx = new Dropbox({ accessToken: process.env.DROPBOX_ACCESS_TOKEN });

// Для пользовательских операций: OAuth2 flow

Загрузка файла

async function uploadFile(filePath: string, fileContent: Buffer): Promise<string> {
  const resp = await dbx.filesUpload({
    path:       filePath,     // '/uploads/documents/contract.pdf'
    contents:   fileContent,
    mode:       { '.tag': 'add' },
    autorename: true,         // если файл существует — добавит (1) к имени
  });

  // Создаём временную shared link
  const linkResp = await dbx.sharingCreateSharedLinkWithSettings({
    path: resp.result.path_display!,
    settings: {
      requested_visibility: { '.tag': 'public' },
      expires: new Date(Date.now() + 7 * 86400000).toISOString(),
    },
  });

  // Конвертируем ссылку для прямого скачивания
  return linkResp.result.url.replace('www.dropbox.com', 'dl.dropboxusercontent.com').replace('?dl=0', '');
}

Chunked Upload для больших файлов

async function chunkedUpload(filePath: string, data: Buffer): Promise<string> {
  const CHUNK_SIZE = 8 * 1024 * 1024;  // 8MB

  // Начало сессии
  const session = await dbx.filesUploadSessionStart({
    contents: data.slice(0, CHUNK_SIZE),
    close:    data.length <= CHUNK_SIZE,
  });

  let offset = CHUNK_SIZE;
  while (offset < data.length) {
    const chunk = data.slice(offset, offset + CHUNK_SIZE);
    const isLast = offset + chunk.length >= data.length;

    if (isLast) {
      await dbx.filesUploadSessionFinish({
        cursor:  { session_id: session.result.session_id, offset },
        commit:  { path: filePath, mode: { '.tag': 'add' } },
        contents: chunk,
      });
    } else {
      await dbx.filesUploadSessionAppendV2({
        cursor:   { session_id: session.result.session_id, offset },
        contents: chunk,
      });
    }
    offset += CHUNK_SIZE;
  }

  return filePath;
}

Webhooks

Dropbox уведомляет о изменениях в папках через webhooks — удобно для синхронизации медиатеки:

Route::post('/webhooks/dropbox', function (Request $request) {
    $signature = $request->header('X-Dropbox-Signature');
    $expected  = hash_hmac('sha256', $request->getContent(), config('services.dropbox.app_secret'));

    if (!hash_equals($expected, $signature)) abort(401);

    foreach ($request->input('list_folder.accounts', []) as $accountId) {
        SyncDropboxFolder::dispatch($accountId);
    }

    return response('ok');
});

Сроки

Загрузка/скачивание файлов с OAuth2: 2–3 рабочих дня.