Actigator API

Интегрируйте данные Actigator в свой сайт, приложение или бот.

Попробовать бесплатно API Explorer

Получите API ключ бесплатно

Зарегистрируйтесь в Actigator — API ключ будет доступен сразу в разделе Настройки → Actigator API. 100 запросов в день бесплатно. Зарегистрироваться →

Содержание

Быстрый старт
Аутентификация
GET /v1/fish
GET /v1/spots
GET /v1/forecast
Лимиты
Примеры кода
API Explorer LIVE

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

Actigator API — это открытый интерфейс для интеграции данных Actigator в ваши продукты. Все ответы предоставляются в формате JSON.

Попробуйте в браузере

Воспользуйтесь нашим интерактивным API Explorer чтобы попробовать все эндпоинты со своим ключом.

Сделайте первый запрос

Прогноз клева окуня в Киеве (fish_id=14):
GET https://api.actigator.com/v1/forecast
    ?api_key=YOUR_API_KEY
    &fish_id=14
    &lat=50.4501
    &lng=30.5234
    &lang=uk
Ответ:
{
  "fish": { "id": 14, "name": "Окунь звичайний" },
  "location": { "lat": 50.4501, "lng": 30.5234 },
  "forecast": {
    "today": {
      "date": "2026-05-14",
      "f_index": 74,
      "hourly": [45, 52, 68, 74, 71, 65, 58, 42]
    },
    "tomorrow": {
      "date": "2026-05-15",
      "f_index": 68,
      "hourly": [40, 48, 62, 68, 65, 58, 50, 38]
    },
    "day_after_tomorrow": {
      "date": "2026-05-16",
      "f_index": 55,
      "hourly": [30, 38, 50, 55, 52, 45, 40, 32]
    }
  }
}

Что такое F-Индекс?

F-Индекс — число от 0 до 100, которое показывает насколько активно будет клевать конкретная рыба. Рассчитывается с помощью регрессионного анализа на основе данных из реальных рыболовных отчётов, погоды, фазы луны и геомагнитной активности.

Аутентификация

Все запросы к API требуют аутентификации через API ключ. Передавайте его как параметр запроса:

GET https://api.actigator.com/v1/forecast?api_key=YOUR_API_KEY&...

Храните ключ в безопасности

Не публикуйте API ключ в публичных репозиториях или клиентском коде. Если ключ скомпрометирован — перегенерируйте его в настройках аккаунта.

Коды ответа

КодОписание
200Успешно
400Неверный запрос — отсутствуют или некорректны параметры
401Не авторизован — неверный или отсутствующий API ключ
429Слишком много запросов — суточный лимит исчерпан
500Ошибка сервера — погодный сервис недоступен
GET

/v1/fish

Возвращает список всех видов рыб, доступных для прогноза. Используйте fish_id в запросе /v1/forecast.

Swagger
ПараметрТипОбязательноОписание
api_keystringдаВаш API ключ
langstringнетЯзык: uk (по умолчанию) или ru
Запрос:
GET https://api.actigator.com/v1/fish?api_key=YOUR_API_KEY&lang=uk
Ответ:
[
  { "id": 14, "name": "Окунь звичайний" },
  { "id": 27, "name": "Щука звичайна" },
  { "id": 8,  "name": "Короп звичайний" },
  ...
]
GET

/v1/spots

Возвращает список мест рыбалки, добавленных в ваш аккаунт. Используйте spot_id в запросе /v1/forecast вместо координат.

Swagger
ПараметрТипОбязательноОписание
api_keystringдаВаш API ключ
langstringнетЯзык: uk (по умолчанию) или ru
Запрос:
GET https://api.actigator.com/v1/spots?api_key=YOUR_API_KEY
Ответ:
[
  {
    "id": 42,
    "name": "Десна біля Чернігова",
    "location": "Чернігів, Україна",
    "lat": 51.4939,
    "lng": 31.2947
  },
  ...
]
GET

/v1/forecast

Главный эндпоинт. Возвращает прогноз клёва F-Индекс на сегодня, завтра и послезавтра для конкретной рыбы в заданном месте.

Swagger

Локация: два варианта

Передайте либо координаты (lat + lng), либо spot_id из /v1/spots. spot_id удобнее если вы используете места рыбалки сохранённые в Actigator.

ПараметрТипОбязательноОписание
api_keystringдаВаш API ключ
fish_idintegerдаID рыбы из /v1/fish
latfloatlat/lng или spot_idШирота
lngfloatlat/lng или spot_idДолгота
spot_idintegerlat/lng или spot_idID места из /v1/spots
langstringнетЯзык: uk (по умолчанию) или ru
Вариант 1 — по координатам:
GET https://api.actigator.com/v1/forecast?api_key=YOUR_API_KEY&fish_id=27&lat=50.4501&lng=30.5234&lang=uk
Вариант 2 — по месту рыбалки:
GET https://api.actigator.com/v1/forecast?api_key=YOUR_API_KEY&fish_id=27&spot_id=42&lang=uk
Ответ:
{
  "fish": { "id": 27, "name": "Щука звичайна" },
  "location": { "lat": 50.4501, "lng": 30.5234 },
  "forecast": {
    "today": {
      "date": "2026-05-14",
      "f_index": 74,
      "hourly": [45, 52, 68, 74, 71, 65, 58, 42]
    },
    "tomorrow": {
      "date": "2026-05-15",
      "f_index": 61,
      "hourly": [30, 35, 55, 61, 58, 50, 44, 38]
    },
    "day_after_tomorrow": {
      "date": "2026-05-16",
      "f_index": 48,
      "hourly": [22, 28, 44, 48, 45, 40, 35, 30]
    }
  }
}

Интерпретация F-Индекс

ЗначениеАктивность
0 — 33Низкая — рыба пассивна
34 — 66Средняя — умеренная активность
67 — 100Высокая — хороший день для рыбалки

Почасовой прогноз

Массив hourly содержит 8 значений F-Индекс для 3-часовых интервалов: 00:00, 03:00, 06:00, 09:00, 12:00, 15:00, 18:00, 21:00 (местное время). Используйте это чтобы найти лучшее время суток для рыбалки.

Лимиты

Лимиты запросов к API зависят от вашего плана.

ПланЛимитRate limiting
Бесплатно100 запросов в день60 в минуту
ProБезлимит60 в минуту

Лимит исчерпан

При достижении лимита API возвращает HTTP 429 Too Many Requests. Перейдите на Pro для неограниченного доступа. Перейти на Pro →

Заголовки rate limit

X-Rate-Limit-Limit: 60
X-Rate-Limit-Remaining: 58
X-Rate-Limit-Reset: 42
  • X-Rate-Limit-Limit — максимум запросов в минуту
  • X-Rate-Limit-Remaining — остаток запросов в текущем окне
  • X-Rate-Limit-Reset — секунд до сброса окна

Примеры кода

PHP (cURL)

<?php

$apiKey = 'YOUR_API_KEY';
$url = "https://api.actigator.com/v1/forecast?" . http_build_query([
    'api_key' => $apiKey,
    'fish_id' => 14,
    'lat'     => 50.4501,
    'lng'     => 30.5234,
    'lang'    => 'uk',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

$today = $data['forecast']['today'];

// Загальний індекс на день
echo "F-Index today: {$today['f_index']}\n";

// Почасовий прогноз
$hours = ['00:00', '03:00', '06:00', '09:00', '12:00', '15:00', '18:00', '21:00'];
foreach ($today['hourly'] as $i => $fIndex) {
    echo "{$hours[$i]} — F-Index: {$fIndex}\n";
}

JavaScript (fetch)

const params = new URLSearchParams({
    api_key: 'YOUR_API_KEY',
    fish_id: 14,
    lat: 50.4501,
    lng: 30.5234,
    lang: 'uk',
});

const res  = await fetch(`https://api.actigator.com/v1/forecast?${params}`);
const data = await res.json();

const today = data.forecast.today;

// Загальний індекс на день
console.log(`F-Index today: ${today.f_index}`);

// Почасовий прогноз
const hours = ['00:00', '03:00', '06:00', '09:00', '12:00', '15:00', '18:00', '21:00'];
today.hourly.forEach((fIndex, i) => {
    console.log(`${hours[i]} — F-Index: ${fIndex}`);
});

Готовы попробовать?

Воспользуйтесь интерактивным API Explorer (Swagger) чтобы протестировать все эндпоинты прямо из браузера.

Мы используем cookies