Copy of API Бензап - Интегрируйте данные о ценах на топливо в ваш бизнес

Описание API Бензап

BaseURL: http://data.omt-consult.ru Метод авторизации: Basic

API Бензап предоставляет доступ к актуальным данным о ценах на топливо, информации о АЗС, данных о конкурентах и других ресурсах, необходимых для эффективного управления топливным бизнесом. Используя API, пользователи могут интегрировать данные о топливе в свои информационные системы, получать аналитику и мониторить рынок в реальном времени.

Основные возможности API:

Получение ценовых данных по АЗС: доступ к актуальным и историческим данным о ценах на топливо на различных АЗС.
Справочники видов топлива: информация о различных типах топлива, доступных на АЗС.
Данные о конкурентных АЗС: возможность сравнения своих АЗС с АЗС конкурентов.
Информация о нефтебазах: данные о местоположении и статусе нефтебаз.
Цены мелкого внебиржевого опта на нефтебазах: актуальные цены на топливо на нефтебазах для мелкого опта.

Структура API

1. Получение списка видов топлива

Endpoint: /api/v1/products
Метод: GET
Описание: Возвращает список всех видов топлива.

Ответ:

  [
      {
          "code": "A0950",
          "name": "АИ-95",
          "full_name": "Премиум-95"
      },
      {
          "code": "A0920",
          "name": "АИ-92",
          "full_name": "Регуляр-92"
      },
      {
          "code": "D0DTB",
          "name": "ДТ-Б",
          "full_name": "ДТ-Б"
      }
  ]

2. Получение данных по АЗС

Endpoint: /api/v1/stations/:stationId
Метод: GET
Значение пути:
- stationId (обязательный) - ID АЗС
Описание: Возвращает данные по запрашиваемому АЗС.

Ответ:

  {
      "id": 28947,
      "name": "Татнефть",
      "number": "358",
      "address": "А180, 31 км, Слева, Ломоносовский р-н, д. Лаголово, ш. Кингисеппское, д. 31к",
      "latitude": 59.717,
      "longitude": 30.04821
  }

3. Получение списка всех АЗС

Endpoint: /api/v1/bulk/stations
Метод: GET
Описание: Возвращает список всех АЗС.

Ответ:

  [
      {
          "id": 2,
          "name": "Газпромнефть",
          "number": "71",
          "region_name": "Тверская область",
          "federal_district": "ЦФО",
          "address": "М10, 152 км, Слева, Калининский р-н, с. Эммаус",
          "status": "active",
          "updated_at": "2024-06-21 14:33:17",
          "longitude": "36.1107",
          "latitude": "56.77858"
      },
      {
          "id": 3,
          "name": "ТрансАЗС",
          "number": "18",
          "region_name": "Московская область",
          "federal_district": "ЦФО",
          "address": "г. Балашиха, ул. Советская, д. 99",
          "status": "active",
          "updated_at": "2024-06-21 14:35:40",
          "longitude": "38.05375",
          "latitude": "55.750816"
      }
  ]

4. Получение списка всех АЗС

Endpoint: /api/v1/bulk/prices
Метод: POST
Формат: application/json
Пример:
```
[
"3", "4", "5"
]
```
Описание: Получение цен по массиву АЗС ID.

Ответ:

  [
      {
          "station_id": 3,
          "product_code": "D0DTL",
          "product_name": "ДТЛ",
          "date": "2024-06-21 14:11:31",
          "price": "63.09"
      },
      {
          "station_id": 3,
          "product_code": "A095B",
          "product_name": "АИ-95Б",
          "date": "2024-06-21 14:11:31",
          "price": "58.29"
      }
  ]

5. Получение текущих цен на топливо по АЗС за период

Endpoint: /api/v1/stations/:stationId/prices
Метод: GET
Описание: Возвращает текущие цены на топливо по указанным АЗС.
Значение пути:
- station_id (обязательный) - ID АЗС
Параметры GET:
- from (необязательный) - Дата начала (пример: 2024-06-01)
- to (необязательный) - Дата окончания (пример: 2024-06-21)

Ответ:

  [
      {
          "station_id": 28947,
          "product_code": "A0950",
          "product_name": "АИ-95",
          "date": "2024-06-18 00:22:08",
          "price": "56.19"
      },
      {
          "station_id": 28947,
          "product_code": "D0DTL",
          "product_name": "ДТЛ",
          "date": "2024-06-18 00:22:08",
          "price": "64.39"
      }
  ]

6. Получение данных о своих и конкурентных АЗС

Endpoint: /api/v1/customer_stations
Метод: GET
Описание: Возвращает данные о своих и конкурентных АЗС.

Ответ:

  [
      {
          "own": {
              "id": 28947,
              "name": "Татнефть",
              "number": "358",
              "address": "А180 31 км Слева Ломоносовский р-н д. Лаголово ш. Кингисеппское д. 31к",
              "latitude": 59.717,
              "longitude": 30.04821
          },
          "competitors": [
              {
                  "id": 23154,
                  "name": "ЛУКОЙЛ",
                  "number": "78133",
                  "address": "А180 30 км Слева г. Красное Село ш.Кингисеппское д. 24",
                  "latitude": 59.719698,
                  "longitude": 30.064462
              }
          ]
      }
  ]

7. Получение списка нефтебаз

Endpoint: /api/api/v1/basis/list
Метод: GET
Описание: Возвращает список нефтебаз.

Ответ:

  [
      {
          "id": 2,
          "name": "Омский НПЗ",
          "type": "PRODUCTION",
          "status": "WORKING",
          "operation_type": "COMMERCIAL",
          "region": "Омская область"
      },
      {
          "id": 3,
          "name": "Ярославнефтеоргсинтез",
          "type": "PRODUCTION",
          "status": "WORKING",
          "operation_type": "COMMERCIAL",
          "region": "Ярославская область"
      }
  ]

8. Получение цен мелкого внебиржевого опта на нефтебазах

Endpoint: /api/api/v1/basis/assortment
Метод: GET
Параметры GET:
- basis_id (обязательный) - Список ID нефтебаз, через запятую
Описание: Возвращает актуальные цены мелкого внебиржевого опта на нефтебазах.

Ответ:

  [
      {
          "basis_id": 21,
          "product": {
              "code": "A0950",
              "name": "АИ-95",
              "full_name": "Премиум-95"
          },
          "trader": {
              "inn": "7453011758",
              "kpp": "027401001",
              "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ЛУКОЙЛ-УРАЛНЕФТЕПРОДУКТ\""
          },
          "price": "60700.00",
          "updated_at": "2024-06-17 13:02:10"
      },
      {
          "basis_id": 21,
          "product": {
              "code": "D0DTL",
              "name": "ДТЛ",
              "full_name": "ДТ летний"
          },
          "trader": {
              "inn": "7453011758",
              "kpp": "027401001",
              "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ЛУКОЙЛ-УРАЛНЕФТЕПРОДУКТ\""
          },
          "price": "64500.00",
          "updated_at": "2024-06-17 13:02:17"
      }
  ]

Дополнительные сведения

Аутентификация: API использует базовую аутентификацию (Basic Auth) для защиты данных. Необходимо предоставить корректные учетные данные для доступа к API.

Форматы данных: API поддерживает формат JSON для входных и выходных данных, обеспечивая легкую интеграцию с любыми современными веб-сервисами и приложениями.

с 9-00 до 18-00

API