API-пайплайн: лайкать карточки и находить их снова

Индекс: API-пайплайны — индекс

Цель: ставить лайки карточкам и находить их снова; проверять, какие карточки вы лайкнули или сохранили.

Все вызовы требуют токен, кроме подсчёта.

Шаги

  1. Лайк или снятие лайка (переключатель).
POST /v0/likes/toggle
{"target_type": "project", "target_nonce": "470000000000000001"}
→ {"liked": true}

Повторный вызов снимает лайк ("liked": false). target_type: project, article, post, workspace, rubric, oracle или campaign.

  1. Ваши лайки одного типа.
GET /v0/likes?target_type=project&limit=20&offset=0
→ {"target_nonces": ["470000000000000001", …], "total": 7}

Откройте каждую через GET /v0/graph/projects/{nonce}.

  1. Отметить список карточек: POST /v0/likes/subset {"target_type": "project", "target_nonces": ["…", "…"]} → {"liked_target_nonces": [...]}. POST /v0/likes/saved-subset с тем же телом отвечает, какие из них сохранены (в любом из ваших рабочих пространств), в том же поле.

  2. Подсчёт: GET /v0/likes/count?target_type=project&target_nonce=470000000000000001 → {"count": 3} (токен не нужен). Страницы и плитки карточек также содержат like_count, fav_count (сколько человек её сохранили) и, для вас, liked_by_viewer / saved_by_viewer.

Что происходит за кадром

Правила

Поверхность API

Эндпоинт Назначение FE ИИ / оракул
POST /v0/likes/toggle Лайк / снять лайк да (сердечко) да
GET /v0/likes Лайкнутые вами карточки одного типа да (Понравившиеся) да
POST /v0/likes/subset Какие из них вы лайкнули да да
POST /v0/likes/saved-subset Какие из них вы сохранили да да
GET /v0/likes/count Лайки карточки да да

Упомянуто