API Документация

REST API для интеграции BoS Files в ваши приложения

О API

BoS Files API позволяет интегрировать функциональность файлообменника в ваши приложения. API доступен для пользователей с тарифом Pro и выше.

Base URL: https://c1.zx72.net/api/v1

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

Используйте API ключ в заголовке Authorization:

curl -H "Authorization: Bearer YOUR_API_KEY" \
    https://c1.zx72.net/api/v1/files

Получите свой API ключ в Настройках → API.

Endpoints

POST /files/upload

Загрузить файл

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/file.pdf" \
  https://c1.zx72.net/api/v1/files/upload

Response:

{
  "success": true,
  "file_id": 123,
  "public_link": "https://c1.zx72.net/download/xyz789abc",
  "size": 1024000,
  "filename": "file.pdf"
}
GET /files

Получить список файлов

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://c1.zx72.net/api/v1/files?page=1&limit=50

Response:

{
  "success": true,
  "files": [...],
  "pagination": {"page": 1, "limit": 50, "total": 100, "pages": 2}
}
GET /files/{file_id}

Получить информацию о файле

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://c1.zx72.net/api/v1/files/123

Response:

{
  "success": true,
  "file": {
    "file_id": 123,
    "filename": "document.pdf",
    "size": 1024000,
    "upload_date": "2024-01-15 10:30:00",
    "download_count": 42,
    "public_link": "https://c1.zx72.net/download/xyz789"
  }
}
DELETE /files/{file_id}

Удалить файл

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://c1.zx72.net/api/v1/files/123

Response:

{"success": true, "message": "File deleted successfully"}
GET /stats

Получить статистику аккаунта

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://c1.zx72.net/api/v1/stats

Response:

{
  "success": true,
  "stats": {"total_files": 50, "total_size": 1073741824, ...},
  "limits": {"max_file_size": 5368709120, "daily_uploads": 500, ...},
  "plan": "pro"
}

Лимиты запросов

Тариф Запросов в минуту Запросов в день
Pro 50 5,000
Business 100 10,000
Enterprise 1,000 100,000

Коды ошибок

Код Описание
400 Неверный запрос (отсутствуют обязательные параметры)
401 Неверный или отсутствующий API ключ
403 Доступ запрещен (тариф не поддерживает API или превышен лимит)
404 Ресурс не найден
429 Превышен лимит запросов

SDK и библиотеки

Официальные SDK для популярных языков программирования:

Python
pip install fileshare-sdk

JavaScript
npm install fileshare

PHP
composer require fileshare

Java
maven: fileshare-sdk

Нужна помощь с API?

Наша команда разработчиков готова помочь с интеграцией

Обновить тариф Получить API ключ