⛽ ГдеТопливо — карта наличия топлива на АЗС России

API для бизнеса

Наличие топлива и цены по ~40 000 АЗС России — для логистических компаний, планирующих маршруты, и других B2B-интеграций.

Публичный API (GET /api/stations, GET /api/clusters) уже используется картой на главной странице — он же доступен внешним клиентам. Для пилотных партнёров выдаётся API-ключ: он снимает анонимные ограничения и даёт собственный лимит запросов в минуту, привязанный к вашему клиенту.

Как получить ключ

Напишите на partners@wherefuel.ru с кратким описанием сценария использования — пришлём ключ и обсудим лимит.

Как использовать

Ключ передаётся заголовком X-Api-Key на уже существующих публичных эндпоинтах:

Запрос	Что возвращает
`GET /api/stations?bbox=lng1,lat1,lng2,lat2`	Список АЗС в прямоугольнике координат: бренд, адрес, координаты, статус наличия, цены
`GET /api/clusters?bbox=...&zoom=...`	Агрегированные кластеры АЗС для широких зон (карта на малом зуме)

Без заголовка X-Api-Key эндпоинты остаются доступны анонимно, как и сейчас — ключ нужен только для собственного (не общего анонимного) лимита и учёта использования.

Пример запроса

curl -H "X-Api-Key: ваш-ключ" "https://wherefuel.ru/api/stations?bbox=37.3,55.5,37.9,55.9"