uploader-bot/docs/API_ENDPOINTS.md

178 lines
3.6 KiB
Markdown

# 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/*