hambi（Beeline 乌兹别克斯坦）数据 API

"UNITEL" LLC · 电信

hambi 是 Beeline 乌兹别克斯坦的自助服务应用，由在乌兹别克斯坦运营 Beeline 品牌的 VEON 集团公司“UNITEL”LLC 发布，面向该运营商的预付费与后付费用户。首页显示以索姆计的主账户余额、剩余的流量（GB）和通话分钟数及各自到期日，以及当前资费、下次续订日期和资费是否已失效。安卓桌面余额小组件提供小、中、大三种尺寸，把这些数字直接放到手机桌面上，并可通过账户选择器指定每个小组件跟踪哪一条线路。账户持有人可以把家人和同住成员的 SIM 卡关联为子账户，为每条线路设置昵称和头像，在线路之间切换查看各自的余额与资费；个人资料区保存用户的姓名和号码、显示主题和界面语言，可选乌兹别克语或俄语。在与 Ucell、Mobiuz、Uzmobile 等运营商竞争的乌兹别克斯坦移动市场中，hambi 是 Beeline 用户日常查余额、跟踪资费续订、用一个账号管理全家线路的主要渠道。

以索姆计的预付费余额、剩余的 GB 流量与通话分钟、资费的下次扣费日期，是 hambi 为每条 Beeline 线路同步的核心内容。仪表盘记录把 core_balance 与 balances 数组配对——每个分桶带有 name、short_name、value、unit 和 expiration_date——并附带 has_balance_traffic 标记，以及当前 plan 的 soc 代码、total_charged_amount、next_apply_dt 续订日期与 is_expired 标记，另有含持有人姓名和 birth_date 的 customer_info 块。

用户资料补充已登录的 MSISDN（phone_number）、first_name、middle_name 与 last_name、如 PREPAID 的 user_type 和账户 status、所选的 language 与 theme，以及 permissions 数组——其 code/state 标记（包括 WIDGET_BALANCE）驱动小组件的账户选择器。每条关联的家庭线路都单独返回一行，带 phone_number、昵称 custom_name、自己的 core_balance、plan、next_apply_dt 和 state，一户人家的多张 SIM 卡可以并排读取。

这些字段直接对应集成场景：家庭看板无需打开应用就能持续显示剩余索姆、GB 与分钟数；家长账户视图在 next_apply_dt 扣费前标记哪张关联 SIM 卡余额不足；计费助手用套餐名称、soc 和 total_charged_amount 生成资费续订日历，并跳过 is_expired 已为 true 的线路；客服工具把工单手机号与持有人姓名、user_type、status 及可选的 birth_date 比对来核实账户持有人。openData Studio 把 hambi 的用户余额、资费、资料与家庭线路变成可调用的开放数据，供基于 Beeline 乌兹别克斯坦账户开发的团队使用。

应用截图

API 端点一览

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

刷新用户访问令牌
POST /v1/session/renew openbanking
把保存的 refresh_token 换成新的 access_token，后者作为 Authorization: Bearer 用于之后每个用户调用。
认证方式：来自已保存用户会话的刷新令牌，以查询参数发送。HTTP 401 时小组件在此调用后重试，然后附加返回的 Bearer access_token。
- access_token
- refresh_token
```
POST /v1/session/renew?refresh_token=d8f1c2e4... HTTP/1.1
platform: android
app-version: 7.59.0
app-build-number: 31002765
language: ru
Date: 2026-09-26T09:00:00Z
UUID: 3f2b8c1d-9a1e-4c2b-8f01-55c17a91f0e2
```
```
{
  "access_token": "eyJhbGciOi...",
  "refresh_token": "d8f1c2e4..."
}
```

获取用户仪表盘余额

GET /v1/account/overview openbanking

返回当前固定到首页小组件的线路：资费套餐、用户姓名、预付费主余额，以及带有效期的剩余流量 / 语音分桶。

认证方式：来自 /v1/session/renew 的 Bearer 令牌（Authorization）。同时发送 language、Date、UUID、Proxy-Authorization、platform=android、app-version、app-build-number 与可选 Cookie。可选的 sub-account-id 请求头选择关联线路。

plan
id
name
soc
next_apply_dt
total_charged_amount
is_expired
customer_info
birth_date
first_name
last_name
middle_name
core_balance
has_balance_traffic
balances
short_name
value
expiration_date
icon
unit

GET /v1/account/overview HTTP/1.1
Authorization: Bearer eyJhbGciOi...
sub-account-id: 18482911
language: ru
platform: android
app-version: 7.59.0

{
  "plan": {
    "id": "SOC_HAMBI24",
    "name": "Hambi 24",
    "soc": "HAMBI24",
    "next_apply_dt": "2026-10-12T00:00:00Z",
    "total_charged_amount": "45000",
    "is_expired": false
  },
  "customer_info": {
    "birth_date": "1994-03-12",
    "first_name": "Aziza",
    "last_name": "Karimova",
    "middle_name": "Olimovna"
  },
  "core_balance": "12500.00",
  "has_balance_traffic": true,
  "balances": [
    {
      "name": "Internet",
      "short_name": "GB",
      "value": "8.4",
      "expiration_date": "2026-10-12T00:00:00Z",
      "icon": "internet",
      "unit": "GB"
    }
  ]
}

读取已登录用户资料
GET /v1/account/owner osint
加载已认证的 Beeline MSISDN、法定姓名、用户类型 / 状态、UI 语言 / 主题，以及小组件账户选择器使用的权限标记。
认证方式：来自 /v1/session/renew 的 Bearer 令牌（Authorization）。同时发送 language、Date、UUID、Proxy-Authorization、platform=android、app-version、app-build-number 与可选 Cookie。
- id
- phone_number
- first_name
- middle_name
- last_name
- user_type
- status
- custom_name
- custom_image
- language
- theme
- addable_as_sub_account
- show_customization_page
- permissions
- code
- state
```
GET /v1/account/owner HTTP/1.1
Authorization: Bearer eyJhbGciOi...
language: uz
platform: android
```
```
{
  "id": 18482911,
  "phone_number": "998901234567",
  "first_name": "Aziza",
  "middle_name": "Olimovna",
  "last_name": "Karimova",
  "user_type": "PREPAID",
  "status": "ACTIVE",
  "custom_name": "My hambi",
  "custom_image": null,
  "language": "ru",
  "theme": "light",
  "addable_as_sub_account": true,
  "show_customization_page": false,
  "permissions": [
    {"id": 1, "code": "WIDGET_BALANCE", "name": "Balance widget", "state": true}
  ]
}
```
列出家庭子账户
GET /v1/account/lines openbanking
返回关联的家庭 / 家人线路，含每个 MSISDN、昵称、core_balance 与套餐，让小组件能通过 sub-account-id 请求头固定某个子账户。
认证方式：来自 /v1/session/renew 的 Bearer 令牌（Authorization）。同时发送 language、Date、UUID、Proxy-Authorization、platform=android、app-version、app-build-number 与可选 Cookie。
- id
- sort
- phone_number
- custom_name
- first_name
- middle_name
- last_name
- core_balance
- plan
- next_apply_dt
- status
- state
- user_type
- custom_image
```
GET /v1/account/lines HTTP/1.1
Authorization: Bearer eyJhbGciOi...
language: ru
platform: android
```
```
[
  {
    "id": 18483002,
    "sort": 1,
    "phone_number": "998907654321",
    "custom_name": "Kids SIM",
    "first_name": "Timur",
    "middle_name": null,
    "last_name": "Karimov",
    "core_balance": 3200.5,
    "plan": "Hambi Kids",
    "next_apply_dt": "2026-10-05T00:00:00Z",
    "status": 1,
    "state": "ACTIVE",
    "user_type": "PREPAID",
    "custom_image": null
  }
]
```

数据类别

余额
套餐
用户资料
子账户

数据使用场景与案例

首页预付费余额同步
运营看板轮询 /v1/account/overview 获取 core_balance、balances[].value/unit/expiration_date 与 plan.is_expired，让家庭不打开应用也能看到剩余索姆、GB 与分钟数。
家庭线路消费概览
家长账户视图把 /v1/account/lines（phone_number、custom_name、core_balance、plan、next_apply_dt）与仪表盘分桶数据关联，在 next_apply_dt 扣费前标记哪张关联 SIM 卡余额不足。
资费续订日历
计费助手把仪表盘返回的 plan.name、soc、total_charged_amount 与 next_apply_dt 复制进续订日历，跳过 is_expired 已为 true 的线路。
用户身份匹配
客服工具在核实账户持有人时，把工单手机号与 /v1/account/owner（phone_number、first_name、last_name、user_type、status）及仪表盘中可选的 customer_info.birth_date 比对。

常见问题

哪个 hambi 端点返回预付费余额与流量包？

GET /v1/account/overview 返回 core_balance、balances 数组（name、short_name、value、unit、expiration_date）和当前套餐（soc、next_apply_dt、is_expired）。传入 sub-account-id 请求头可读取关联线路。

hambi 小组件如何保持登录？

它保存已登录会话的 access_token 与 refresh_token。POST /v1/session/renew?refresh_token=… 签发新令牌对；后续调用发送 Authorization: Bearer 加 language、Date、UUID 与 app-version 请求头。

hambi 能暴露家庭或额外 SIM 卡，而不只是机主线路吗？

可以。GET /v1/account/lines 返回每条关联线路的 phone_number、custom_name、core_balance、plan 和 next_apply_dt。小组件随后以该行的 id 作为 sub-account-id 请求头调用账户概览。

hambi 用户资料端点返回什么？

GET /v1/account/owner 返回已登录的 MSISDN（phone_number）以及 first_name、last_name、user_type 和 status，外加 UI 偏好（language、theme）和 permissions 数组——其中 code/state 标记（如 WIDGET_BALANCE）驱动小组件的账户选择器。

与 hambi (Beeline Uzbekistan) 相似的应用

Ucell — Ucell 是 COSCOM 为乌兹别克斯坦用户提供的官方自助应用，可查询余额、更换套餐、用银行卡充值，并在同一账号下管理多个号码。
Mobiuz — Mobiuz 是 Universal Mobile Systems 面向乌兹别克斯坦的账户应用，用来查看余额与剩余流量、充值、开通或关闭服务，以及更换资费套餐。
My Uztelecom — My Uztelecom 是乌兹别克电信面向 Uzmobile 手机与 Uzonline 家庭宽带用户的官方应用，可查看剩余流量、购买短信/上网/语音包并更换套餐。
HUMANS — HUMANS 是运行在乌兹别克斯坦 UzMobile 网络上的数字运营商，其超级应用可在同一处办理资费、激活 SIM、充值与卡对卡转账。
OQ — OQ 是 UNITEL 面向乌兹别克斯坦的数字运营商：用户在应用里自选号码、拼装语音/短信/流量套餐，远程完成身份核验后开通 eSIM 或实体卡。

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

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

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

获取报价

hambi（Beeline 乌兹别克斯坦）数据 API

应用截图

API 端点一览

刷新用户访问令牌

获取用户仪表盘余额

读取已登录用户资料

列出家庭子账户

数据类别

数据使用场景与案例

首页预付费余额同步

家庭线路消费概览

资费续订日历

用户身份匹配

常见问题

与 hambi (Beeline Uzbekistan) 相似的应用

更多电信类应用

Azercell

Hathway Broadband

Mi Claro Ecuador

Minha Vero

相关主题

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

hambi（Beeline 乌兹别克斯坦）数据 API

应用截图

API 端点一览

刷新用户访问令牌

获取用户仪表盘余额

读取已登录用户资料

列出家庭子账户

数据类别

数据使用场景与案例

首页预付费余额同步

家庭线路消费概览

资费续订日历

用户身份匹配

常见问题

相关应用

与 hambi (Beeline Uzbekistan) 相似的应用

更多电信类应用

Azercell

Hathway Broadband

Mi Claro Ecuador

Minha Vero

相关主题

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