Fbenz Partner API

Карта наличия топлива в вашем продукте

Водители по всей России отмечают на карте Fbenz, где есть бензин и очереди. Эта страница за пару минут объяснит, как показать эти данные вашим клиентам. Программист не обязателен.

Подключить Справочник разработчика

28 000+АЗС в базе

~5 минутот отметки водителя до API

Индивидуальноусловия и лимиты под партнёра

Сначала выберите свой путь

Их два. Не знаете, какой ваш? Почти всем подходит первый.

Путь 1 · подходит почти всем

Готовая карта на ваш сайт

Мы даём готовую карту без нашего логотипа: кластеры, фильтр по топливу, поиск. У каждой АЗС один из пяти статусов наличия, легенда есть прямо на карте:

есть очередь мало нет нет данных

Статусы ставят сами водители: и в приложении fbenz.ru, и прямо в вашей карте кнопкой «Обновить статус». Отметка «топлива нет» выходит на карту после подтверждения второго человека, чтобы одна ошибка не увела людей от живой заправки. Тем, кто ещё не подтверждён, карта показывает плашку с кнопкой «Подтверждаю».

Вы вставляете одну строку на свой сайт или в приложение. Всё, дальше карта живёт и обновляется сама.

Программист не нужен
Из знаний достаточно уметь копировать и вставлять
Четыре шага, обычно минут десять

Показать 4 шага

Путь 2 · для разработчиков

Чистые данные в вашу карту

У вас своё приложение со своей картой, и вы хотите рисовать статусы в своём стиле. Тогда вам наш JSON API: координаты, статусы, цены, поиск, фильтры и отчёты ваших пользователей.

Нужен разработчик на вашей стороне
Снапшот всей России + дешёвые обновления раз в пару минут
Вся техника собрана в отдельном справочнике

Открыть справочник

Готовая карта: 4 шага

Рассчитано на человека, который никогда ничего не подключал. Застряли на любом шаге? Напишите нам, доведём до конца вместе.

Напишите нам и получите ключ

Напишите в Telegram: t.me/fbenz_ru. Расскажите пару слов о продукте и назовите адрес сайта, где будет карта, например demobank.ru. Обсудим условия и выдадим вам ключ: строку вида pk_live_AbC123…

Зачем адрес сайта. Ключ привязывается к нему и работает только там. Даже если кто-то подсмотрит ключ в коде страницы, на чужом сайте он бесполезен.
Сохраните ключ в заметки: он показывается один раз при выдаче.

Соберите свой тег из готовых кусочков

Тег это та самая одна строка для вставки. Ничего писать не нужно: выберите настройки, тег ниже соберётся сам. Останется нажать «Копировать».

Ваш ключ из шага 1 Это не тот ключ. Для карты нужен ключ, который начинается с pk_live_. Ключ fb_live_ секретный, его на сайт вставлять нельзя.

Город при открытии

Тема карты

Топливо при открытии

Спрятать панель фильтров Спрятать поиск

Ваш тег, скопируйте целиком

Нужен другой город? Впишите любой город России в скопированном теге вместо выбранного, кавычки и остальное не трогайте.

Вставьте тег на свой сайт

Тег вставляется туда, где должна появиться карта. Где это место, зависит от того, на чём сделан сайт:

Свой сайт на HTML. Откройте файл страницы и вставьте тег в нужное место, например перед закрывающим </body>.
Tilda. Добавьте блок T123 «HTML-код», вставьте тег внутрь, опубликуйте страницу.
WordPress. В редакторе страницы добавьте блок «Пользовательский HTML» и вставьте тег.
Bitrix. Компонент «HTML-код», вставьте тег.
Приложение. Отдайте тег разработчику со словами «покажи это в вебвью». Ему этого достаточно.

Проверьте, что всё получилось

Откройте свою страницу в браузере. Карта с АЗС должна появиться сразу, без всяких настроек. Как это выглядит у других, можно посмотреть на живом примере: витрина «Демо Банка».

Если карта не появилась, почти всегда это одна из трёх причин:

Что видите	В чём дело и что делать
Картинка с котом и код 403	Карта открыта на сайте, к которому ключ не привязан. Напишите нам адрес сайта, добавим его к ключу за минуту.
Пустой прямоугольник	Скорее всего, ключ вставлен с опечаткой или не целиком. Соберите тег заново в шаге 2 и замените старый.
Карта есть, но город не тот	Поправьте название города прямо в теге, в кусочке `city=…`

После этого карта живёт сама: данные обновляются каждые пару минут, ничего поддерживать или обновлять на вашей стороне не нужно.

Разработчикам: данные в вашу карту

Если карту рисует ваша команда, ей нужен наш JSON API. Эта часть техническая, поэтому живёт на отдельной странице.

Что внутри справочника

Первый запрос за 10 минут: пошагово, с командами для Windows и macOS
Восемь методов: города, АЗС по городу или области карты, поиск, фильтры
Отчёты ваших пользователей: они смогут ставить статусы прямо из вашего приложения
Готовый клиент на Python и JavaScript: скопировать и запустить
Свежесть данных, лимиты, коды ошибок и разбор частых вопросов

Открыть справочник разработчика Спецификация OpenAPI

Не разобрались?

Это нормально, для того мы и на связи.

Напишите нам: t.me/fbenz_ru. Поможем выбрать путь, соберём тег за вас, проверим вставку на вашем сайте и подскажем разработчикам по API. Обычно отвечаем быстро.