πŸš€ Vizzon API

v1.6.2 β€’ ONLINE

πŸ“‹ ДоступныС endpoints (33+ Ρ€ΠΎΡƒΡ‚Π°):

GET /health - статус API
GET /api/rate-limits - статистика rate limiting

πŸ” АутСнтификация (6 Ρ€ΠΎΡƒΡ‚ΠΎΠ²):

GET /api/sessions - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ сСссий
DELETE /api/sessions - ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ Π΄Ρ€ΡƒΠ³ΠΈΡ… сСссий
GET /api/auth/viewer-id - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ID ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ
POST /api/auth/logout - Π²Ρ‹Ρ…ΠΎΠ΄ ΠΈΠ· систСмы
POST /api/validate-telegram - валидация Telegram Π°Π²Ρ‚ΠΎΡ€ΠΈΠ·Π°Ρ†ΠΈΠΈ
GET /api/tgusers?tg_id=123 - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ ΠΏΠΎ tg_id

πŸ“ Висты (7 Ρ€ΠΎΡƒΡ‚ΠΎΠ²):

GET /api/vists?authorId=123 - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ списка вистов
POST /api/vists - созданиС Π½ΠΎΠ²ΠΎΠ³ΠΎ виста
GET /api/vists/search?q=тСкст&type=text - поиск вистов ΠΏΠΎ тСксту/Ρ…ΡΡˆΡ‚Π΅Π³Π°ΠΌ
GET /api/vists/:vistId - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΠΊΠΎΠ½ΠΊΡ€Π΅Ρ‚Π½ΠΎΠ³ΠΎ виста
PATCH /api/vists/:vistId - ΠΎΠ±Π½ΠΎΠ²Π»Π΅Π½ΠΈΠ΅ виста
DELETE /api/vists/:vistId - ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ виста
GET /api/vists/:vistId/redirect - Ρ€Π΅Π΄ΠΈΡ€Π΅ΠΊΡ‚ Π½Π° страницу виста

❀️ Π Π΅Π°ΠΊΡ†ΠΈΠΈ ΠΈ Π·Π°ΠΊΠ»Π°Π΄ΠΊΠΈ (3 Ρ€ΠΎΡƒΡ‚Π°):

POST /api/vists/:vistId/reaction - Π»Π°ΠΉΠΊ/Π΄ΠΈΠ°Π»Π°ΠΉΠΊ виста
GET /api/vists/:vistId/bookmark - ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΊΠ° наличия Π·Π°ΠΊΠ»Π°Π΄ΠΊΠΈ
POST /api/vists/:vistId/bookmark - Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΠ΅/ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ Π·Π°ΠΊΠ»Π°Π΄ΠΊΠΈ

πŸ’¬ ΠšΠΎΠΌΠΌΠ΅Π½Ρ‚Π°Ρ€ΠΈΠΈ (5 Ρ€ΠΎΡƒΡ‚ΠΎΠ²):

GET /api/vists/:vistId/comments - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΠΊΠΎΠΌΠΌΠ΅Π½Ρ‚Π°Ρ€ΠΈΠ΅Π² виста
POST /api/vists/:vistId/comments - Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΠ΅ коммСнтария
GET /api/vists/:vistId/comments/:commentId - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΠΊΠΎΠ½ΠΊΡ€Π΅Ρ‚Π½ΠΎΠ³ΠΎ коммСнтария
PATCH /api/vists/:vistId/comments/:commentId - Ρ€Π΅Π΄Π°ΠΊΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ коммСнтария
DELETE /api/vists/:vistId/comments/:commentId - ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ коммСнтария

πŸ“Š ДСйствия ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Π΅ΠΉ (5 Ρ€ΠΎΡƒΡ‚ΠΎΠ²):

GET /api/user-actions - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ истории дСйствий ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ
GET /api/user-actions/reactions - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ Ρ€Π΅Π°ΠΊΡ†ΠΈΠΉ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ
GET /api/user-bookmarks - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ Π·Π°ΠΊΠ»Π°Π΄ΠΎΠΊ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ Π½Π° ΠΏΡ€ΠΎΡ„ΠΈΠ»ΠΈ
GET /api/users/:vizzon_id/bookmark - ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΊΠ° Π·Π°ΠΊΠ»Π°Π΄ΠΊΠΈ Π½Π° ΠΏΡ€ΠΎΡ„ΠΈΠ»ΡŒ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ
POST /api/users/:vizzon_id/bookmark - Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΠ΅/ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ Π·Π°ΠΊΠ»Π°Π΄ΠΊΠΈ Π½Π° ΠΏΡ€ΠΎΡ„ΠΈΠ»ΡŒ
GET /api/users/sociallinks-by-id/:vizzon_id - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ссылок соцсСтСй ΠΏΠΎ ID πŸ†•
GET /api/users/:username - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ профиля ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ ΠΏΠΎ username πŸ†•

πŸ”” Упоминания (3 Ρ€ΠΎΡƒΡ‚Π°):

GET /api/mentions/notifications - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΡƒΠ²Π΅Π΄ΠΎΠΌΠ»Π΅Π½ΠΈΠΉ ΠΎΠ± упоминаниях
POST /api/mentions/notifications - ΠΎΡ‚ΠΌΠ΅Ρ‚ΠΊΠ° ΡƒΠ²Π΅Π΄ΠΎΠΌΠ»Π΅Π½ΠΈΠΉ ΠΊΠ°ΠΊ ΠΏΡ€ΠΎΡ‡ΠΈΡ‚Π°Π½Π½Ρ‹Ρ…
GET /api/mentions/has-new - ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΊΠ° Π½ΠΎΠ²Ρ‹Ρ… ΡƒΠΏΠΎΠΌΠΈΠ½Π°Π½ΠΈΠΉ

πŸ“ž ΠžΠ±Ρ€Π°Ρ‚Π½Π°Ρ связь (1 Ρ€ΠΎΡƒΡ‚):

POST /api/feedback - ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠ° сообщСния ΠΎΠ±Ρ€Π°Ρ‚Π½ΠΎΠΉ связи

πŸ–ΌοΈ Аватарки (10 Ρ€ΠΎΡƒΡ‚ΠΎΠ²):

GET /api/avatar/user/:vizzon_id - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ Π°Π²Π°Ρ‚Π°Ρ€ΠΊΠΈ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ ΠΏΠΎ ID
GET /api/avatar/username/:username - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ Π°Π²Π°Ρ‚Π°Ρ€ΠΊΠΈ ΠΏΠΎ username
POST /api/avatar/batch - Π³Ρ€ΡƒΠΏΠΏΠΎΠ²ΠΎΠ΅ ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ Π°Π²Π°Ρ‚Π°Ρ€ΠΎΠΊ (Π΄ΠΎ 50 ID)
POST /api/avatar/upload - Π·Π°Π³Ρ€ΡƒΠ·ΠΊΠ° Π½ΠΎΠ²ΠΎΠΉ Π°Π²Π°Ρ‚Π°Ρ€ΠΊΠΈ (Ρ‚Ρ€Π΅Π±ΡƒΠ΅Ρ‚ Π°ΡƒΡ‚Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ†ΠΈΠΈ)
GET /api/avatar/manager/get - ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΈΠ΅ ΠΌΠ΅Π½Π΅Π΄ΠΆΠ΅Ρ€Π° Π°Π²Π°Ρ‚Π°Ρ€ΠΎΠΊ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ
POST /api/avatar/manager/set-current - установка Ρ‚Π΅ΠΊΡƒΡ‰Π΅ΠΉ Π°Π²Π°Ρ‚Π°Ρ€ΠΊΠΈ
DELETE /api/avatar/manager/delete-one - ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ ΠΎΠ΄Π½ΠΎΠΉ Π°Π²Π°Ρ‚Π°Ρ€ΠΊΠΈ
DELETE /api/avatar/manager/delete-all - ΡƒΠ΄Π°Π»Π΅Π½ΠΈΠ΅ всСх Π°Π²Π°Ρ‚Π°Ρ€ΠΎΠΊ
POST /api/avatar/manager/set-tgava-current - ΠΈΠΌΠΏΠΎΡ€Ρ‚ Π°Π²Π°Ρ‚Π°Ρ€ΠΊΠΈ ΠΈΠ· Telegram πŸ†•
GET /api/avatar/telegram-avatar/resolve?src=SVG_URL - конвСртация Telegram SVG β†’ JPG/PNG πŸ†•

🚦 Rate Limiting:

πŸ”’ ΠšΡ€ΠΈΡ‚ΠΈΡ‡Π½Ρ‹Π΅ Ρ€ΠΎΡƒΡ‚Ρ‹: ТёсткиС Π»ΠΈΠΌΠΈΡ‚Ρ‹
βš™οΈ Π‘Ρ‚Π°Π½Π΄Π°Ρ€Ρ‚Π½Ρ‹Π΅ Ρ€ΠΎΡƒΡ‚Ρ‹: 200 req/min
🌐 Π“Π»ΠΎΠ±Π°Π»ΡŒΠ½Ρ‹ΠΉ Π»ΠΈΠΌΠΈΡ‚: 1000 req/min
🚫 Π‘Π»ΡƒΠΆΠ΅Π±Π½Ρ‹Π΅ Ρ€ΠΎΡƒΡ‚Ρ‹: Π±Π΅Π· Π»ΠΈΠΌΠΈΡ‚ΠΎΠ²