uploader-bot/docs/API_ENDPOINTS.md

3.6 KiB

API Endpoints (local compose) — 2025-08-03T06:57:18Z

База: http://localhost:8000

Источник: /openapi.json + фактические GET-запросы

Сводка

  • Title: MY Network Uploader Bot - FastAPI
  • Version: 3.0.0
  • Description: Decentralized content uploader with web2-client compatibility

Перечень путей

  • /auth.twa
  • /auth.selectWallet
  • /api/v1/auth/register
  • /api/v1/auth/login
  • /api/v1/auth/refresh
  • /api/v1/auth/me
  • /content.view/{content_id}
  • /blockchain.sendNewContentMessage
  • /blockchain.sendPurchaseContentMessage
  • /api/storage
  • /api/storage/upload/{upload_id}/status
  • /api/storage/upload/{upload_id}
  • /api/storage/api/v1/storage/upload
  • /api/storage/api/v1/storage/quota
  • /api/node/handshake
  • /api/node/content/sync
  • /api/node/network/ping
  • /api/node/network/status
  • /api/node/network/discover
  • /api/node/v3/node/status
  • /api/node/v3/network/stats
  • /api/system/health
  • /api/system/health/detailed
  • /api/system/metrics
  • /api/system/info
  • /api/system/stats
  • /api/system/maintenance
  • /api/system/logs
  • /api/system/ready
  • /api/system/live
  • /health
  • /
  • /api
  • /api/v1/ping
  • /favicon.ico

Фактическая проверка ключевых эндпоинтов

Health

GET http://localhost:8000/health

Status: 200

Response: { "cache": "healthy", "database": "healthy", "status": "healthy", "timestamp": "2025-08-03T06:57:18.764238", "uptime_seconds": 220 }

System Health

GET http://localhost:8000/api/system/health

Status: 200

Response: { "services": { "cache": "healthy", "cryptography": "healthy", "database": "healthy" }, "status": "healthy", "timestamp": "2025-08-03T06:57:18.796817", "uptime_seconds": 220 }

System Info

GET http://localhost:8000/api/system/info

Status: 200

Response: { "api_version": "v1", "capabilities": [ "content_upload", "content_sync", "decentralized_filtering", "ed25519_signatures", "web2_client_api" ], "max_file_size": 104857600, "network": "MY Network v3.0", "node_id": "node-fedd1eb42d0eb949", "public_key": "fedd1eb42d0eb94948f9e29802cc617cff614e3199baacfb8eb753ce8a3c8da2", "service": "uploader-bot", "supported_formats": [ "image/", "video/", "audio/", "text/", "application/pdf" ], "timestamp": "2025-08-03T06:57:18.837394", "version": "unknown" }

Node Network Status

GET http://localhost:8000/api/node/network/status

Status: 200

Response: { "data": { "capabilities": [ "content_upload", "content_sync", "decentralized_filtering", "ed25519_signatures" ], "node_id": "node-fedd1eb42d0eb949", "public_key": "fedd1eb42d0eb94948f9e29802cc617cff614e3199baacfb8eb753ce8a3c8da2", "status": "active", "timestamp": "2025-08-03T06:57:18.867139", "version": "3.0.0" }, "success": true }

Node v3 Status

GET http://localhost:8000/api/node/v3/node/status

Status: 200

Response: { "capabilities": [ "content_upload", "content_sync", "decentralized_filtering", "ed25519_signatures" ], "network": "MY Network", "node_id": "node-fedd1eb42d0eb949", "status": "online", "timestamp": "2025-08-03T06:57:18.899336", "version": "3.0.0" }

Storage Root

GET http://localhost:8000/api/storage

Status: 405

Response: { "detail": "Method Not Allowed" }

Несовпадающие/устаревшие пути

  • /api/v3/node/status и /api/my/monitor/ возвращают 404 в текущей сборке; используйте /api/node/v3/node/status и /api/system/*