API
Документация
Интегрируйте Feedbackly в ваш продукт за 15 минут. RESTful API, вебхуки и полная прозрачность данных. Прямая связь. Без фильтров.
Authentication
Доступ к API осуществляется через Bearer-токены. Все запросы должны быть отправлены через HTTPS. Токены генерируются в личном кабинете в разделе "Настройки интеграции".
Генерация токена
Используйте ваш Client ID и Secret для получения access_token.
curl -X POST https://api.feedbackly.ru/v1/auth/token \
-H "Content-Type: application/json" \
-d '{
"client_id": "fb_prod_8821",
"client_secret": "sk_live_992812..."
}'Endpoints
Основные ресурсы для управления сбором отзывов и получения сырых данных.
Список кампаний
Возвращает список всех активных и завершенных кампаний сбора обратной связи для вашего аккаунта.
Создать кампанию
Создает новую задачу для сбора отзывов. Принимает параметры бюджета, таргетинга и временных рамок.
Сырые данные
Выгрузка необработанных текстов отзывов в формате JSON или CSV. Доступно сразу после получения.
Примеры кода (JSON)
Request Body
Структура запроса для создания новой кампании. Обязательные поля: name, budget.
"name": "Анализ UX мобильного приложения",
"budget": 15000,
"currency": "RUB",
"target_audience": [
"developers",
"designers"
],
"deadline": "2023-11-15T23:59:59Z"
}
Response Object
Стандартный ответ API при успешном создании задачи (Status 201).
"status": "success",
"data": {
"id": "cmp_99281",
"slug": "ux-mobile-app-99281",
"state": "pending_payment",
"created_at": "2023-10-24T10:30:00Z"
}
}
Статусы ответов
Мы используем стандартные HTTP-коды для обозначения успеха или типа ошибки.
200 / 201
OK / Created
Запрос выполнен успешно. Данные получены или ресурс создан.
400 / 401
Bad Request / Unauthorized
Ошибка в синтаксисе JSON или истек срок действия токена. Проверьте права доступа.
500
Internal Server Error
Мы что-то сломали. Попробуйте повторить запрос через 30 секунд или свяжитесь с поддержкой.