Ключ, адрес, аутентификация
Бета. Контракт может меняться. Доступ к боевому API открывается после подключения (оплаты). Форму данных можно проверить заранее по тестовому ключу - см. Проверка данных.
Тестовый ключ (песочница)
Проверить форму данных можно сразу, до договора - по общему тестовому ключу. Он открывает только POST /v1/validate: проверка структуры и связности вашего payload, без записи и скоринга. Скопируйте:
feelin_test_397a6c88dde38430f9c6f83ad2d75bfb9ce3b12a
Подробнее о проверке - Проверка данных.
Боевой ключ
После заключения договора вы получаете доступ и создаёте персональный API-ключ в кабинете Филина (раздел настроек). Все боевые запросы (приём данных, выдача результатов) идут с ним - данные жёстко привязаны к вашему аккаунту и изолированы от других клиентов.
Базовый адрес
https://api.feelin.tech/v1
Аутентификация
В каждом запросе - заголовок:
Authorization: Bearer <ваш-ключ>
Без ключа или с неверным ключом эндпоинт вернёт 401 (см. Коды ответов и ошибки).
Формат запросов
- Тело запроса - JSON в кодировке UTF-8.
- Заголовок
Content-Type: application/json. - Приёмные эндпоинты принимают массив объектов (bulk) - см. Батчи и идемпотентность.
Проверка перед боем
Прежде чем слать данные в работу, прогоните payload на эндпоинте POST /v1/validate - он проверит структуру и связность и вернёт ошибки построчно, ничего не записывая. Подробно - Проверка данных.
Дальше
- Минимум для старта и пример - первый результат за один цикл.
- Модель данных - какие сущности и поля отдавать.