RECOMS Cloud · API v1

Документация

Добавьте комментарии в собственный продукт через server-to-server API. Ваш backend отвечает за пользователей и авторизацию, а RECOMS — за хранение, обсуждения и модерацию.

Быстрый старт

Первый запрос проходит через проект и backend вашего приложения.

  1. 01
    Создайте проект
    Откройте Projects в RECOMS Cloud и создайте проект.
  2. 02
    Сохраните API-ключ
    Создайте ключ проекта и храните его только на сервере.
  3. 03
    Отправьте комментарий
    Передайте обязательные resourceId и стабильный authorUserId.

Создать комментарий

Запрос отправляет backend клиента. Замените примерный API host на адрес своего Cloud deployment.

curl https://api.recoms.example/v1/comments \
  -H "Authorization: Bearer $RECOMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resourceId": "article:42",
    "authorUserId": "usr_7f2",
    "content": "Начнём обсуждение."
  }'

Не передавайте API-ключ в браузер. RECOMS не аутентифицирует конечных пользователей: используйте стабильный внешний идентификатор пользователя из своего приложения.