GuVault API Documentation

https://api.guvault.com

curl -X POST https://api.guvault.com/upload/file \
  -F "file=@document.pdf" \
  -F "expires_in_hours=24" \
  -F "password=secret123"

curl -X POST https://api.guvault.com/upload/message \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Секретное сообщение!",
    "expires_in_hours": 48,
    "password": "mypassword"
  }'

HTTP/1.1 200 OK
Content-Type: text/plain

OK

curl https://api.guvault.com/health

curl -X POST https://api.guvault.com/upload/file \
  -F "file=@document.pdf" \
  -F "expires_in_hours=24" \
  -F "max_downloads=5" \
  -F "password=secret123" \
  -F "alias=my-document"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "access_code": "file_my-document",
  "download_url": "/download/file_my-document",
  "expires_at": "2025-09-30T20:18:18Z",
  "max_downloads": 5
}

{
  "content": "Текст сообщения",
  "expires_in_hours": 24,
  "max_downloads": 10,
  "password": "secret123",
  "alias": "my-message"
}

curl -X POST https://api.guvault.com/upload/message \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Это секретное сообщение!",
    "expires_in_hours": 48,
    "max_downloads": 3,
    "password": "mypassword",
    "alias": "secret-note"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "access_code": "msg_secret-note",
  "download_url": "/download/msg_secret-note",
  "expires_at": "2025-10-01T20:18:18Z",
  "max_downloads": 3
}

{
  "password": "secret123"
}

# Скачивание файла
curl https://api.guvault.com/download/file_my-document

# Скачивание с паролем
curl -X POST https://api.guvault.com/download/file_my-document \
  -H "Content-Type: application/json" \
  -d '{"password": "secret123"}'

# Скачивание сообщения
curl https://api.guvault.com/download/msg_secret-note

{
  "type": "file",
  "alias": "my-alias"
}

{
  "available": false,
  "suggestions": ["my-alias1", "my-alias2", "my-alias3"]
}

curl -X POST https://api.guvault.com/alias/check \
  -H "Content-Type: application/json" \
  -d '{
    "type": "file",
    "alias": "my-document"
  }'

// Загрузка файла
async function uploadFile(file, options = {}) {
  const formData = new FormData();
  formData.append('file', file);
  
  if (options.expiresInHours) {
    formData.append('expires_in_hours', options.expiresInHours);
  }
  if (options.password) {
    formData.append('password', options.password);
  }

  const response = await fetch('https://api.guvault.com/upload/file', {
    method: 'POST',
    body: formData
  });

  return await response.json();
}

// Загрузка сообщения
async function uploadMessage(content, options = {}) {
  const response = await fetch('https://api.guvault.com/upload/message', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ content, ...options })
  });

  return await response.json();
}

import requests
import json

class GuVaultAPI:
    def __init__(self, base_url="https://api.guvault.com"):
        self.base_url = base_url
    
    def upload_file(self, file_path, **options):
        """Загрузка файла"""
        with open(file_path, 'rb') as f:
            files = {'file': f}
            data = {k: v for k, v in options.items() if v is not None}
            
            response = requests.post(
                f"{self.base_url}/upload/file",
                files=files,
                data=data
            )
            return response.json()
    
    def upload_message(self, content, **options):
        """Загрузка сообщения"""
        data = {'content': content, **options}
        
        response = requests.post(
            f"{self.base_url}/upload/message",
            json=data
        )
        return response.json()

# Пример использования
api = GuVaultAPI()

# Загрузка файла
result = api.upload_file(
    'document.pdf',
    expires_in_hours=24,
    max_downloads=5,
    password='secret123',
    alias='my-document'
)
print(f"Файл загружен: {result['download_url']}")

import { useState, useCallback } from 'react';

interface UploadOptions {
  expiresInHours?: number;
  maxDownloads?: number;
  password?: string;
  alias?: string;
}

export function useGuVault() {
  const [loading, setLoading] = useState(false);
  const [error, setError] = useState<string | null>(null);

  const uploadFile = useCallback(async (file: File, options: UploadOptions = {}) => {
    setLoading(true);
    setError(null);
    
    try {
      const formData = new FormData();
      formData.append('file', file);
      
      Object.entries(options).forEach(([key, value]) => {
        if (value !== undefined) {
          formData.append(key, String(value));
        }
      });

      const response = await fetch('https://api.guvault.com/upload/file', {
        method: 'POST',
        body: formData
      });

      if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
      }

      return await response.json();
    } catch (err) {
      setError(err instanceof Error ? err.message : 'Unknown error');
      throw err;
    } finally {
      setLoading(false);
    }
  }, []);

  return { uploadFile, loading, error };
}