Публичное API

Общие правила

• Все ответы — JSON, кодировка UTF-8.
• Публичные эндпоинты не требуют авторизации и CSRF-токена.
• Админские эндпоинты требуют авторизацию и CSRF-токен.
• Rate limits применяются по IP клиента (flask-limiter, storage memory:// или Redis).
• Ошибки: 429 — rate limit, 404 — не найдено, 400 — невалидный ввод, 500 — ошибка сервера.

Загрузка мема

Загрузка изображения (multipart/form-data). Мем создаётся как неопубликованный до модерации.

curl -X POST https://смешнявки.рф/api/upload \
  -F "file=@meme.png" \
  -F "title=Смешной мем" \
  -F "description=Описание" \
  -F "tags=кот,смешное"

Ответ 201:

{
  "success": true,
  "meme_id": 123,
  "filename": "abc123.avif",
  "warning": "Похожий мем уже есть (#456)"  // optional
}

Лимит: 10 загрузок/мин на IP. Файл конвертируется в AVIF, EXIF удаляется.

Лайки

Инкремент счётчика лайков (не toggle).

// 200
{"liked": true, "count": 43}

// 429 — rate limit (3 лайка в 30 с)
// 404 — мем не найден

// 200
{"liked": false, "count": 43}

IP не хранится — «лайкнуто» вернуть невозможно, только счётчик.

Реакции (эмодзи)

Тело: {"reaction": "🗿"}. Допустимые: 🗿 🔥 🥺 👏 💔 🤡 💀

// 200
{"reaction": "🗿", "count": 5, "counts": {"🗿": 5, "🔥": 0, ...}}

// 400 — неизвестный эмодзи
// 429 — 3 реакции в 30 с
// 404 — мем не найден/неопубликован

// 200
{"counts": {"🗿": 5, "🔥": 0, ...}}

Комментарии

Content-Type: application/json. Тело: {"nickname": "Аноним", "text": "Отличный мем!"}

// 201
{"success": true}

// 429 — 1 комментарий/мин или дубликат за 5 мин
// 400 — пустой текст, >2000 символов, невалидный parent
// 404 — мем не найден

// 200
{"comments": [{"id", "nickname", "text", "created_at", "replies": [...]}],
 "next_cursor": 123}

Только approved-комментарии с ветками; limit ≤ 50. Никнейм санитизируется, HTML из текста вырезается.

Прочее

Админские (требуют авторизацию + CSRF)

Публичные страницы (HTML)

HTMX-фрагменты

Запросы с заголовком HX-Request: true возвращают HTML-фрагменты (partials/meme_items.html) вместо полных страниц. Используется для infinite scroll. Библиотека HTMX не подключена — клиентский JS отправляет заголовок через fetch.