AZS 油站数据 API：油价、积分与泵岛付款

TD NM, OOO · 支付

АЗС Нефтьмагистраль（AZS Neftmagistral）是 Нефтьмагистраль 加油站网络的官方车主应用，由 TD NM, OOO 在 Google Play 上架。俄罗斯司机用它在地图上定位附近 АЗС、比较实时油品、在车内完成泵岛付款、启动充电、在站内便利店下单，并累积积分、优惠券与加油员礼遇。登录靠手机号加短信验证码或 Mobile ID。它与卢克石油、俄气石油、俄石油等大型油企的品牌应用以及多品牌泵岛支付钱包同场，是该连锁自有油站的第一方客户端。

每座映射油站带有实时 fuels 及分标号 price，以及 latitude、longitude、address、closed 与充电 connectors。积分钱包给出 bonuses、bonusLevel、currentAmount、overdraftLimit 和充电用的 electro 余额。加油流水含 litres、amount、gasStationAddress 与 receiptUrl；泵岛会话列出带分标号 limit 的 columns；进行中的订单跟踪 status、payment、bonusesPayment 与 paymentUrl；便利店购物篮汇总 payment、minPayment 与 cashback。

车队油耗工具按油站油价核对升数，积分运营盯着等级与优惠券 expiredDate，泵岛看板轮询进行中的 fueling 与 charging 订单。openData Studio 把这些对象变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

用手机号注册会话
POST /v1/azs/auth/phone-session openfinance
为手机号（短信）或 Mobile ID（hheUri）打开登录会话。sessionId 由 SessionStatus 轮询，并由 ConfirmCode 消费。
认证方式：无需认证。启动手机号 / Mobile ID 登录；确认步骤消费短信或 Mobile ID 结果。
- phone
- campaign
- promocode
- captchaToken
- theme
- mobileId
- sessionId
- authType
- hheUri
```
POST /v1/azs/auth/phone-session HTTP/1.1
Content-Type: application/json

{
  "phone": "79001234567",
  "campaign": null,
  "promocode": null,
  "captchaToken": "captcha-token-example",
  "theme": "LIGHT",
  "mobileId": 0
}
```
```
{
  "sessionId": 1842201,
  "authType": 1,
  "hheUri": null
}
```
确认短信或 Mobile ID 验证码
POST /v1/azs/auth/sms-confirm openfinance
消费短信 / Mobile ID 验证码，返回 UserModel 信封（id、偏好 fuelTypeId、会话 token、账户状态）。
认证方式：无需认证。请求体为手机号会话步骤得到的 ConfirmModel（code、phone、mobileId）。
- code
- phone
- mobileId
- id
- fuelTypeId
- token
- testStatus
- status
- statusInfo
```
POST /v1/azs/auth/sms-confirm HTTP/1.1
Content-Type: application/json

{
  "code": "482913",
  "phone": "79001234567",
  "mobileId": 0
}
```
```
{
  "id": 551002,
  "fuelTypeId": 3,
  "token": "nm-session-token-example",
  "testStatus": 0,
  "status": 1,
  "statusInfo": null
}
```
签发认证 token
POST /v1/azs/auth/token openfinance
签发 AuthTokenModel.token（以及登录时附带的 campaign/promocode），后续 IronWater 请求将其作为会话凭证发送。
认证方式：短信确认之后的无认证引导。返回的 token 作为后续油站、订单、便利店与积分调用的会话凭证。
- token
- campaign
- promocode
```
POST /v1/azs/auth/token HTTP/1.1
Content-Type: application/json

{}
```
```
{
  "token": "nm-session-token-example",
  "campaign": null,
  "promocode": null
}
```

列出附近加油站

POST /v1/azs/stations/nearby opendata

按 location（及可选促销/商品/商店过滤）返回地图钉列表：油站 id、坐标、实时油价、充电枪与营业时间。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

id
name
number
latitude
longitude
address
type
pinType
distance
closed
yandexId
favorite
fuels
price
connectors
workTimes
presenceInTheRadius
location

POST /v1/azs/stations/nearby HTTP/1.1
Content-Type: application/json

{
  "promoId": null,
  "productId": null,
  "presentId": null,
  "goodOrderId": null,
  "serviceId": null,
  "query": null,
  "location": [55.7558, 37.6173]
}

[
  {
    "id": 412,
    "name": "АЗС Нефтьмагистраль 12",
    "number": "12",
    "latitude": 55.7891,
    "longitude": 37.5402,
    "address": "Москва, Ленинградское шоссе, 25",
    "type": 0,
    "pinType": 1,
    "distance": 840,
    "closed": false,
    "message": "",
    "yandexId": "ym-gs-412",
    "favorite": true,
    "fuels": [
      {"id": 3, "name": "АИ-95", "color": "#E31E24", "default": true, "price": 62.49}
    ],
    "connectors": [],
    "workTimes": [
      {"title": "Круглосуточно", "days": 127, "start": "00:00", "end": "23:59", "date": null}
    ],
    "presenceInTheRadius": true
  }
]

读取加油站详情

POST /v1/azs/stations/card opendata

加载单站卡片（GasStationDetails）：简介、电话、操作按钮、照片，以及继承的地图字段与实时油品。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

id
extendedId
location
name
address
description
phone
fuels
price
services
connectors
hashedImages
closed

POST /v1/azs/stations/card HTTP/1.1
Content-Type: application/json

{
  "id": 412,
  "extendedId": null,
  "location": [55.7558, 37.6173]
}

{
  "id": 412,
  "name": "АЗС Нефтьмагистраль 12",
  "number": "12",
  "latitude": 55.7891,
  "longitude": 37.5402,
  "address": "Москва, Ленинградское шоссе, 25",
  "closed": false,
  "description": "Магазин, мойка, зарядка",
  "phone": "+74951234567",
  "fuels": [
    {"id": 3, "name": "АИ-95", "color": "#E31E24", "default": true, "price": 62.49}
  ],
  "services": [{"id": 8, "name": "Мойка"}],
  "connectors": ["CCS2"],
  "hashedImages": []
}

加载泵岛加油会话

POST /v1/azs/pumps/session openbanking

返回该站泵岛快照：带分标号升数上限的加油枪、实时油品、快捷金额以及消费上限提示。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

id
name
address
columns
number
disabled
fuelTypes
limit
fuels
price
offers
quickValues
limitSpent
limitSpentText

POST /v1/azs/pumps/session HTTP/1.1
Content-Type: application/json

{
  "id": 412
}

{
  "id": 412,
  "name": "АЗС Нефтьмагистраль 12",
  "address": "Москва, Ленинградское шоссе, 25",
  "columns": [
    {"id": 1, "number": "3", "disabled": false, "fuelTypes": [{"id": 3, "limit": 80}]}
  ],
  "fuels": [
    {"id": 3, "name": "АИ-95", "color": "#E31E24", "default": true, "price": 62.49}
  ],
  "offers": [],
  "quickValues": [{"value": 1000}, {"value": 2000}, {"value": 3000}],
  "limitSpent": false,
  "limitSpentText": null
}

读取忠诚积分
POST /v1/azs/loyalty/wallet openbanking
读取首页/资料页展示的积分钱包：积分、等级、累计消费、透支、充电 electro 余额、幸运转盘次数与礼品目录。
认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。
- bonuses
- bonusLevel
- currentAmount
- overdraftLimit
- overdraftEnabled
- fortuneCount
- fortuneExpiredDate
- electro
- chipPromoId
- levels
- products
- presents
- gurmanika
- fuelingEmployees
```
POST /v1/azs/loyalty/wallet HTTP/1.1
Content-Type: application/json

{}
```
```
{
  "bonuses": 12480,
  "bonusLevel": 2,
  "currentAmount": 1860.5,
  "overdraftLimit": 500,
  "overdraftEnabled": true,
  "fortuneCount": 1,
  "fortuneExpiredDate": 1769904000,
  "electro": 12.4,
  "chipPromoId": 0,
  "levels": [],
  "products": [],
  "presents": [],
  "gurmanika": null,
  "fuelingEmployees": null
}
```

分页加油与积分流水

POST /v1/azs/loyalty/ledger openbanking

分页返回会员流水（加油与仅积分行），含油站、升数、金额与财政小票 URL。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

from
to
type
categories
pageNumber
pageSize
onlyBonuses
id
gasStation
gasStationAddress
date
category
text
title
amount
litres
receiptUrl
value

POST /v1/azs/loyalty/ledger HTTP/1.1
Content-Type: application/json

{
  "from": 1756684800,
  "to": 1769904000,
  "type": null,
  "categories": [],
  "pageNumber": 1,
  "pageSize": 20,
  "onlyBonuses": false
}

[
  {
    "id": 908812334,
    "gasStation": "АЗС Нефтьмагистраль 12",
    "gasStationAddress": "Москва, Ленинградское шоссе, 25",
    "date": 1767225600,
    "type": 1,
    "category": 2,
    "text": "АИ-95",
    "title": "Заправка",
    "amount": 2499.6,
    "litres": 40.0,
    "receiptUrl": "/receipts/908812334",
    "value": "40.00 л"
  }
]

读取会员资料

POST /v1/azs/members/profile osint

返回已登录车主卡片：手机号、姓名、邮箱确认、偏好油品以及积分/促销通知开关。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

phone
name
email
emailConfirmed
photo
birthdate
gender
fuelType
promocode
mailing
notifyBonuses
notifyPromo
status
mailReceipt

POST /v1/azs/members/profile HTTP/1.1
Content-Type: application/json

{}

{
  "phone": "79001234567",
  "name": "Иван Петров",
  "email": "[email protected]",
  "emailConfirmed": true,
  "photo": null,
  "birthdate": 494640000,
  "gender": 1,
  "fuelType": {"id": 3, "name": "АИ-95", "color": "#E31E24", "default": true},
  "promocode": null,
  "mailing": true,
  "notifyBonuses": true,
  "notifyPromo": false,
  "status": 1,
  "mailReceipt": true
}

列出支付方式

POST /v1/azs/payments/methods openbanking

按支付 scope 列出已保存卡与其他付款方式，含收单行、终端号与掩码 PAN。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

scope
acquiringBank
terminal
methods
type
name
hintText
cardId
cardPan
cardType
paymentToken
addCardButton

POST /v1/azs/payments/methods HTTP/1.1
Content-Type: application/json

{
  "scope": 0
}

{
  "acquiringBank": 1,
  "terminal": "nm-term-12",
  "methods": [
    {
      "type": 1,
      "name": "Visa ••4242",
      "hintText": "",
      "cardId": "card-881",
      "cardPan": "4242",
      "cardType": 1,
      "icon": null,
      "cardTypeIcon": null,
      "paymentToken": null
    }
  ],
  "addCardButton": {"visible": true}
}

创建加油或充电订单

POST /v1/azs/orders/start openfinance

启动泵岛加油或充电订单（POST，g=1）。响应为驱动付款页与泵岛授权的 OrderStatusModel。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

orderTypes
objectType
objectId
boxId
serviceId
connectorId
sumToPay
liters
phone
email
paymentId
id
status
paymentType
amount
current
payment
bonusesPayment
paymentUrl
fuelPrice
errorCode

POST /v1/azs/orders/start HTTP/1.1
Content-Type: application/json

{
  "orderTypes": 1,
  "objectType": 1,
  "objectId": 412,
  "boxId": 1,
  "serviceId": null,
  "connectorId": null,
  "sumToPay": 2499.6,
  "liters": 40.0,
  "phone": "79001234567",
  "email": "[email protected]"
}

{
  "paymentId": "pay-7781",
  "id": 99021,
  "status": 1,
  "paymentType": 1,
  "amount": 2499.6,
  "current": 0.0,
  "payment": 2499.6,
  "bonusesPayment": 0.0,
  "paymentUrl": "/pay/session/7781",
  "fuelPrice": 62.49,
  "message": null,
  "errorCode": null
}

轮询订单状态
POST /v1/azs/orders/live openfinance
轮询进行中的加油/充电订单：已加升数（current）、已扣金额（payment）、积分抵扣以及错误码 M101/M102/M103。
认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。
- id
- paymentId
- status
- paymentType
- amount
- current
- payment
- bonusesPayment
- paymentUrl
- fuelPrice
- message
- errorCode
```
POST /v1/azs/orders/live HTTP/1.1
Content-Type: application/json

{
  "id": 99021
}
```
```
{
  "paymentId": "pay-7781",
  "id": 99021,
  "status": 3,
  "paymentType": 1,
  "amount": 2499.6,
  "current": 18.4,
  "payment": 1149.8,
  "bonusesPayment": 0.0,
  "paymentUrl": null,
  "fuelPrice": 62.49,
  "message": null,
  "errorCode": null
}
```
读取进行中的加油与充电订单
POST /v1/azs/orders/active openfinance
返回首页横幅使用的进行中泵岛会话和/或充电会话（当枪或充电口占用时）。
认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。
- fueling
- charging
- id
- title
- paymentType
- objectId
- createdDate
- stationName
- connectorType
```
POST /v1/azs/orders/active HTTP/1.1
Content-Type: application/json

{}
```
```
{
  "fueling": {
    "id": 99021,
    "title": "Колонка 3 · АИ-95",
    "paymentType": 1,
    "objectId": 412
  },
  "charging": {
    "id": null,
    "createdDate": null,
    "stationName": null,
    "connectorType": null
  }
}
```

读取站内便利店购物篮

POST /v1/azs/shop/basket openfinance

返回站内便利店购物篮（可带 couponId）：应付合计、最低消费、返现以及每行价格/折扣/积分。

认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。

couponId
payment
minPayment
cashback
items
goodId
title
price
totalPrice
discount
count
amount
bonuses
couponApplyingResult

POST /v1/azs/shop/basket HTTP/1.1
Content-Type: application/json

{
  "couponId": 2201
}

{
  "payment": 489.0,
  "minPayment": 100.0,
  "cashback": 24,
  "items": [
    {
      "id": 11,
      "type": 1,
      "goodId": "g-441",
      "title": "Кофе 0.3",
      "price": 189.0,
      "totalPrice": 189.0,
      "discount": 0.0,
      "count": 1.0,
      "amount": 189.0,
      "cashback": 9,
      "bonuses": 0.0
    }
  ],
  "actions": [],
  "couponApplyingResult": null
}

列出忠诚优惠券
POST /v1/azs/loyalty/coupons openfinance
按 CouponsFilter.scope（加油 vs 便利店）列出优惠券：文案、面值、到期日与即将过期天数，供钱包与购物篮界面使用。
认证方式：携带 POST /v1/azs/auth/token 返回的会话 token。手机号会话、短信确认与签发 token 无需登录。
- scope
- id
- scopes
- expiredDate
- text
- shortDescription
- description
- value
- daysBeforeExpiring
- showProgress
```
POST /v1/azs/loyalty/coupons HTTP/1.1
Content-Type: application/json

{
  "scope": 1
}
```
```
[
  {
    "id": 2201,
    "scopes": 1,
    "expiredDate": 1772496000,
    "text": "-5 ₽/л АИ-95",
    "shortDescription": "На заправку",
    "description": "Скидка 5 ₽ на литр АИ-95",
    "value": "5",
    "daysBeforeExpiring": 12,
    "showProgress": false
  }
]
```

数据类别

加油站
油价
忠诚积分
交易流水
泵岛订单
电动车充电
便利店购物篮
支付方式
优惠券
会员资料

数据使用场景与案例

车队油耗对账
车队后台把每位司机的 litres 与 amount 对照油站实时 fuels.price 和 gasStationAddress，报销不必再靠纸质小票。
积分与透支监控
CRM 任务在加油后读取 bonuses、bonusLevel、currentAmount 与 overdraftLimit，标出 overdraftEnabled 消费即将触顶的钱包。
泵岛与充电状态看板
油站运营屏轮询进行中的 fueling（title、objectId）与 charging（stationName、connectorType）订单以及 OrderStatus 的 current/payment，让加油员看到哪把枪或充电口在忙。
便利店购物篮券核验
商品运营在收银促销上线前把 couponId 套到购物篮，比较 payment、minPayment、cashback 与 couponApplyingResult。

常见问题

油站记录包含哪些字段？

每个地图钉带有 id、name、number、latitude、longitude、address、带分标号 price 的实时 fuels、充电 connectors、workTimes、closed 以及可选 yandexId。详情卡再加 description、phone 与 hashedImages。

积分钱包如何表示？

忠诚钱包返回 bonuses、bonusLevel、currentAmount、overdraftLimit、overdraftEnabled 以及充电用的 electro 余额，外加幸运转盘次数与礼品目录。优惠券提供 id、scopes、value 与 expiredDate；加油流水分页返回每次的 litres、amount 与 receiptUrl。

泵岛付款在数据里怎么体现？

泵岛会话返回 columns（number、disabled、分标号 limit）和实时 fuels。开单用 objectId、boxId、sumToPay、liters；状态轮询 current 升数、payment、bonusesPayment 与 errorCode；进行中列表用横幅展示加油或充电订单。

司机如何登录？

手机号会话提交 phone（及可选 captchaToken / mobileId），返回 sessionId 和可选的 Mobile ID hheUri。确认步骤消费短信或 Mobile ID 验证码并返回 UserModel；随后签发后续调用使用的会话 token。

与 АЗС Нефтьмагистраль 相似的应用

IndianOil ONE — 印度石油公司的消费者应用，可定位加油站、查看实时油价并在加油时累积 XTRAREWARDS，是另一市场的燃油零售积分钱包。
ЛУКОЙЛ — 卢克石油在俄罗斯的官方油站应用，用于查找 АЗС、泵岛付款并累积该公司积分。
АЗС Газпромнефть — 俄气石油的品牌加油站应用，含地图检索、油价、应用内支付与「Нам по пути」积分计划。
АЗС Роснефть — 俄石油面向其俄罗斯油站网络的官方应用：定位、油品与该公司的积分卡。
Яндекс Заправки — Yandex 的多品牌泵岛付款应用，司机可在合作的俄罗斯油站从车内启动加油。
Татнефть АЗС — 鞑靼石油面向其鞑靼斯坦及周边油站网络的应用，含油价、支付与品牌积分卡。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

AZS 油站数据 API：油价、积分与泵岛付款

应用截图

API 端点一览

用手机号注册会话

确认短信或 Mobile ID 验证码

签发认证 token

列出附近加油站

读取加油站详情

加载泵岛加油会话

读取忠诚积分

分页加油与积分流水

读取会员资料

列出支付方式

创建加油或充电订单

轮询订单状态

读取进行中的加油与充电订单

读取站内便利店购物篮

列出忠诚优惠券

数据类别

数据使用场景与案例

车队油耗对账

积分与透支监控

泵岛与充电状态看板

便利店购物篮券核验

常见问题

与 АЗС Нефтьмагистраль 相似的应用

更多支付类应用

CashBook - Balance & Expense

Dhan Barse

IndianOil ONE

inyad Konnash: Bookkeeping App

相关主题

需要集成这个 App 的数据 API？