API-пайплайн: лайкать карточки и находить их снова
Индекс: API-пайплайны — индекс
Цель: ставить лайки карточкам и находить их снова; проверять, какие карточки вы лайкнули или сохранили.
Все вызовы требуют токен, кроме подсчёта.
Шаги
- Лайк или снятие лайка (переключатель).
POST /v0/likes/toggle
{"target_type": "project", "target_nonce": "470000000000000001"}
→ {"liked": true}
Повторный вызов снимает лайк ("liked": false). target_type: project, article, post, workspace, rubric, oracle или campaign.
- Ваши лайки одного типа.
GET /v0/likes?target_type=project&limit=20&offset=0
→ {"target_nonces": ["470000000000000001", …], "total": 7}
Откройте каждую через GET /v0/graph/projects/{nonce}.
Отметить список карточек:
POST /v0/likes/subset{"target_type": "project", "target_nonces": ["…", "…"]}→{"liked_target_nonces": [...]}.POST /v0/likes/saved-subsetс тем же телом отвечает, какие из них сохранены (в любом из ваших рабочих пространств), в том же поле.Подсчёт:
GET /v0/likes/count?target_type=project&target_nonce=470000000000000001→{"count": 3}(токен не нужен). Страницы и плитки карточек также содержатlike_count,fav_count(сколько человек её сохранили) и, для вас,liked_by_viewer/saved_by_viewer.
Что происходит за кадром
- Сохранение — это не лайк: карточка сохранена, когда она лежит в одном из ваших рабочих пространств. API-пайплайн: собирать карточки в рабочие пространства
Правила
- 400
unsupported target_type: <type>. - 401 без токена (кроме
count).
Поверхность API
| Эндпоинт | Назначение | FE | ИИ / оракул |
|---|---|---|---|
POST /v0/likes/toggle |
Лайк / снять лайк | да (сердечко) | да |
GET /v0/likes |
Лайкнутые вами карточки одного типа | да (Понравившиеся) | да |
POST /v0/likes/subset |
Какие из них вы лайкнули | да | да |
POST /v0/likes/saved-subset |
Какие из них вы сохранили | да | да |
GET /v0/likes/count |
Лайки карточки | да | да |