API

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

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

О API

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

Base URL https://games22.fun/api/v1

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

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

Authorization: Bearer YOUR_API_KEY

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

Endpoints

POST /files/upload

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

Запрос

curl -X POST https://games22.fun/api/v1/files/upload \
  -H "Authorization: Bearer $BOSX_KEY" \
  -F "file=@report.pdf"

Ответ

{
  "success": true,
  "file_id": 1042,
  "public_link": "https://games22.fun/download/a1b2c3d4",
  "size": 2481920,
  "filename": "report.pdf"
}

GET /files

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

Запрос

curl https://games22.fun/api/v1/files?page=1&limit=50 \
  -H "Authorization: Bearer $BOSX_KEY"

Ответ

{
  "success": true,
  "files": [ ... ],
  "pagination": { "page": 1, "limit": 50, "total": 128, "pages": 3 }
}

GET /files/{file_id}

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

Запрос

curl https://games22.fun/api/v1/files/1042 \
  -H "Authorization: Bearer $BOSX_KEY"

Ответ

{
  "success": true,
  "file": {
    "file_id": 1042,
    "filename": "report.pdf",
    "size": 2481920,
    "upload_date": "2026-07-29 10:30:00",
    "download_count": 42,
    "public_link": "https://games22.fun/download/a1b2c3d4"
  }
}

DELETE /files/{file_id}

Удалить файл

Запрос

curl -X DELETE https://games22.fun/api/v1/files/1042 \
  -H "Authorization: Bearer $BOSX_KEY"

Ответ

{ "success": true, "message": "File deleted successfully" }

GET /stats

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

Запрос

curl https://games22.fun/api/v1/stats \
  -H "Authorization: Bearer $BOSX_KEY"

Ответ

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

Примеры запросов

Скопируйте пример на своём языке и подставьте собственный ключ.

# Загрузить файл
curl -X POST https://games22.fun/api/v1/files/upload \
  -H "Authorization: Bearer $BOSX_KEY" \
  -F "file=@report.pdf"

import os, requests

API = "https://games22.fun/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['BOSX_KEY']}"}

with open("report.pdf", "rb") as f:
    r = requests.post(f"{API}/files/upload", headers=HEADERS, files={"file": f})

r.raise_for_status()
print(r.json()["public_link"])

const API = "https://games22.fun/api/v1";

const body = new FormData();
body.append("file", fileInput.files[0]);

const res = await fetch(`${API}/files/upload`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.BOSX_KEY}` },
  body,
});

const data = await res.json();
console.log(data.public_link);

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

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

Коды ошибок

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

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

Напишите нам — поможем с интеграцией.

Обновить тариф Помощь