REST API v1

Управляйте облаком
через API

Полный доступ к файловому хранилищу, пользователям и метаданным. Интегрируйте an4rch в свои приложения за считанные минуты.
https://api.an4rch.com/v1

Файлы и папки

GET /files
Получить список всех файлов в аккаунте.
curl -X GET https://api.an4rch.com/v1/files \
  -H "Authorization: Bearer YOUR_TOKEN"
Пример ответа
{
  "data": [
    { "id": "file_123", "name": "document.pdf", "size": 2048000, "created_at": "2025-03-20T10:00:00Z" }
  ],
  "total": 42
}
POST /files/upload
Загрузить новый файл в облако. Поддержка multipart/form-data.
curl -X POST https://api.an4rch.com/v1/files/upload \
  -F "file=@image.png" \
  -H "Authorization: Bearer YOUR_TOKEN"
GET /files/:id
Получить информацию о конкретном файле или скачать его (с параметром ?download=true).
curl -X GET https://api.an4rch.com/v1/files/file_123 \
  -H "Authorization: Bearer YOUR_TOKEN"
DELETE /files/:id
Безвозвратно удалить файл из облака.
curl -X DELETE https://api.an4rch.com/v1/files/file_123 \
  -H "Authorization: Bearer YOUR_TOKEN"

Управление аккаунтом

GET /user/info
Получить информацию о текущем пользователе, лимиты хранилища, использованное место.
curl -X GET https://api.an4rch.com/v1/user/info \
  -H "Authorization: Bearer YOUR_TOKEN"
PUT /user/settings
Обновить настройки профиля (имя, язык, тема).
curl -X PUT https://api.an4rch.com/v1/user/settings \
  -H "Content-Type: application/json" \
  -d '{"theme":"dark"}' \
  -H "Authorization: Bearer YOUR_TOKEN"

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

POST /auth/token
Получить JWT токен для доступа к API по email и паролю.
curl -X POST https://api.an4rch.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"email":"user@an4rch.com","password":"secret"}'

API ключи для разработчиков

Управляйте доступом, создавайте токены в личном кабинете.