openData StudioEnglish
hambi (Beeline Uzbekistan) 图标

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

"UNITEL" LLC · 电信

在 Google Play 中打开

hambi 是 UNITEL 旗下 Beeline 乌兹别克斯坦的自助服务应用。首页小组件从 /v1/account/overview 加载剩余话费与流量，通过 /v1/account/profile 识别已登录的 MSISDN，在 /v1/account/lines 列出家庭线路，并在 /v1/session/renew 续期用户会话。

每个调用都携带应用通过 refresh-token 交换续期的 Bearer 访问令牌，可选的 sub-account-id 请求头把余额视图切换到关联的家庭线路。

hambi 是 UNITEL 旗下 Beeline 乌兹别克斯坦的自助服务应用：预付费与后付费用户从首页及安卓小组件查看主余额、流量包、资费状态与关联的家庭线路。小组件栈与私有 HTTPS API 通信，完成会话续期、登录资料、家庭子账户，以及返回 plan、customer_info、core_balance 与分桶余额的账户概览。这些字段同时驱动小 / 中 / 大三种余额小组件，以及用户把线路固定到首页时使用的账户选择器。

应用截图

  • hambi (Beeline Uzbekistan) 应用截图 1
  • hambi (Beeline Uzbekistan) 应用截图 2
  • hambi (Beeline Uzbekistan) 应用截图 3
  • hambi (Beeline Uzbekistan) 应用截图 4
  • hambi (Beeline Uzbekistan) 应用截图 5
  • hambi (Beeline Uzbekistan) 应用截图 6
  • hambi (Beeline Uzbekistan) 应用截图 7

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/profile 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/profile 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/profile（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/profile 返回已登录的 MSISDN（phone_number）以及 first_name、last_name、user_type 和 status，外加 UI 偏好（language、theme）和 permissions 数组——其中 code/state 标记（如 WIDGET_BALANCE）驱动小组件的账户选择器。

更多电信类应用

相关主题

  • hambi API
  • Beeline 乌兹别克斯坦
  • UNITEL
  • 用户余额 API
  • core_balance
  • 子账户
  • 资费 next_apply_dt
  • hambi 小组件
  • Beeline 自助服务数据 API

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

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

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

获取报价