Asiacell 数据 API：余额、用量与充值

ASIACELL COMMUNICATIONS PJSC · 电信

Asiacell 是 ASIACELL COMMUNICATIONS PJSC 用户的自助服务应用。MSISDN + OTP 登录后，客户端调用 /v2/dashboard/home 获取套餐、剩余流量包与 Shukran 积分，调用 /v1/usage/records 获取 My Pocket 话单级使用记录，调用 /v1/billing/balance 获取伊拉克第纳尔 mainBalance——账单金额、支付通道、话费转赠与叠加包则在同级路径上。

每个登录调用都携带 OTP 确认步骤签发的 Authorization: Bearer accessToken，因此余额、用量、目录与忠诚度读取共享同一个会话。

Asiacell 是 ASIACELL COMMUNICATIONS PJSC 为伊拉克预付费与后付费用户提供的自助服务应用：首页展示套餐、剩余流量包与忠诚度积分，My Pocket 列出话单级使用记录，钱包流程覆盖充值卡 / 在线充值、后付费账单金额、话费转赠和 Shukran 奖励。MSISDN + OTP 登录后，客户端对每个私有 HTTPS API 调用都附带 Bearer accessToken——仪表盘、使用记录、余额与订阅者资料端点返回这些屏幕所用的实时线路、伊拉克第纳尔余额与资料。

应用截图

API 端点一览

发起 MSISDN 登录并请求 OTP
POST /v1/auth/start osint
为订阅者手机号发起 Asiacell 自助服务登录，可按需进行验证码校验，并返回 nextUrl，其中的 PID 是确认短信 OTP 必需的参数。
认证方式：无需认证。请求体为订阅者 MSISDN（username）加可选的 captchaCode（来自验证码签发调用）。成功后 nextUrl 携带 OTP 确认步骤使用的 PID。
- username
- captchaCode
- requireCaptcha
- success
- message
- nextUrl
- PID
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/auth/start HTTP/1.1
Content-Type: application/json

{
  "username": "7701234567",
  "captchaCode": ""
}
```
```
{
  "requireCaptcha": false,
  "success": true,
  "message": "OTP sent",
  "nextUrl": "asiacell://otp?PID=pid-8f21a4"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的手机号登录流程重构
- nextUrl 中的 PID 是 OTP 确认界面提交的值
确认短信 OTP 并签发会话
POST /v1/auth/verify osint
为登录 PID 确认短信 OTP，并返回应用会话保存的 accessToken / refreshToken 对、订阅者 userId、MSISDN、fullName 和 userType。
认证方式：无需认证。请求体携带登录 nextUrl 中的 PID、短信验证码和可选 token。返回的 accessToken 在后续调用中作为 Authorization: Bearer 发送。
- PID
- passcode
- token
- accessToken
- refreshToken
- userId
- username
- fullName
- secret
- language
- tokenType
- userType
- success
- message
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/auth/verify HTTP/1.1
Content-Type: application/json

{
  "PID": "pid-8f21a4",
  "passcode": "482913",
  "token": ""
}
```
```
{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example",
  "refreshToken": "rt-c91e2b",
  "userId": 18482911,
  "username": "7701234567",
  "fullName": "Ahmed Ali",
  "secret": "sk-asiacell-7c11",
  "language": "en",
  "tokenType": "Bearer",
  "userType": "PREPAID",
  "success": true,
  "message": "Logged in"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的 OTP 确认步骤重构
- 令牌对与资料字段同应用会话中保存的内容一致
获取登录后的首页仪表盘
GET /v2/dashboard/home openbanking
返回登录后的首页数据：当前套餐名称、剩余余额 / 流量磁贴，以及 Asiacell 首页使用的 Shukran 忠诚度 remain/total。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。可选的 lat/lon 查询参数来自设备。
- success
- message
- nextAction
- data
- plan
- title
- name
- points
- value
- loyaltyPoint
- remain
- total
- expiration
- registered
- icon
- logo
- color
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v2/dashboard/home?lat=33.3152&lon=44.3661 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "nextAction": null,
  "data": {
    "plan": {
      "title": "Your plan",
      "name": "Asiacell Super 15"
    },
    "points": [
      {"title": "Balance", "value": "12500 IQD"},
      {"title": "Data", "value": "8.4 GB"}
    ],
    "loyaltyPoint": {
      "title": "Shukran",
      "value": "420",
      "remain": 420.0,
      "total": 1000.0,
      "expiration": "2026-12-31",
      "registered": true,
      "icon": "shukran",
      "logo": "https://cdn.example.com/static/shukran.png",
      "color": "#E30613"
    }
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的首页仪表盘重构
- 套餐、磁贴与忠诚度字段同首页渲染的内容对应
读取订阅者资料
GET /v1/account/profile osint
加载已认证订阅者的法定姓名分段、MSISDN、邮箱与头像，展示在账户 / 资料界面。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。
- success
- message
- title
- nextAction
- data
- firstName
- lastName
- thirdName
- phone
- email
- photo
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/account/profile HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "title": "Profile",
  "nextAction": null,
  "data": {
    "firstName": "Ahmed",
    "lastName": "Ali",
    "thirdName": "Hassan",
    "phone": "7701234567",
    "email": "[email protected]",
    "photo": "https://cdn.example.com/media/profile/18482911.jpg"
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的账户 / 资料界面重构
列出使用记录
GET /v1/usage/records opendata
为 My Pocket 返回分页的话单记录列表：语音 / 流量 / 短信行含 amount、unit、对方号码副标题与描述，外加 total/limit/page。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。用 limit/page 分页；查看明细列表需要先通过短信 OTP 确认步骤。
- success
- message
- data
- amount
- unit
- title
- subTitle
- description
- total
- limit
- page
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/usage/records?page=1&limit=20 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "data": {
    "data": [
      {
        "amount": "150",
        "unit": "IQD",
        "title": "Voice",
        "subTitle": "07701234568",
        "description": "2 min 14 sec · 2026-09-26 18:42"
      },
      {
        "amount": "24",
        "unit": "MB",
        "title": "Data",
        "subTitle": "Mobile internet",
        "description": "2026-09-26 19:10"
      }
    ],
    "total": 86,
    "limit": 20,
    "page": 1
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的 My Pocket 使用列表重构
- 列表分页且需通过短信 OTP 确认
读取充值前的预付费主余额
GET /v1/billing/balance openbanking
在用户选择充值卡或在线支付方式之前，返回充值界面展示的预付费 mainBalance 与币种。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。
- success
- message
- title
- nextAction
- data
- mainBalance
- currency
- note
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/billing/balance HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "title": "Recharge",
  "nextAction": null,
  "data": {
    "title": "Main balance",
    "mainBalance": 12500.0,
    "currency": "IQD",
    "note": "Valid until 12 Oct 2026"
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的充值界面重构
查询后付费账单金额
GET /v1/billing/invoice openfinance
返回缴账单流程在支付 POST 之前使用的未付后付费账单金额（data）与 dueDate。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。
- success
- message
- title
- data
- dueDate
- nextAction
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/billing/invoice HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "title": "Current bill",
  "data": 18500.0,
  "dueDate": "2026-10-05",
  "nextAction": null
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的缴账单流程重构

列出充值支付方式

GET /v1/billing/payment-methods openfinance

列出用户在确认充值前可选的充值卡与在线充值通道（FastPay、AsiaPay 及其他钱包）。

认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。

success
message
data
title
desc
voucherPayment
onlinePayments
id
icon
selected

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/billing/payment-methods HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "success": true,
  "message": "OK",
  "data": {
    "title": "How do you want to pay?",
    "desc": "Choose a voucher or online wallet",
    "voucherPayment": {
      "title": "Scratch card"
    },
    "onlinePayments": [
      {
        "id": 2,
        "title": "FastPay",
        "icon": "fastpay",
        "selected": true
      },
      {
        "id": 4,
        "title": "AsiaPay",
        "icon": "asiapay",
        "selected": false
      }
    ]
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据应用的支付方式选择界面重构

发起话费转赠
POST /v1/transfers/initiate openbanking
发起一笔到另一个 Asiacell 号码的预付费话费转赠，并返回 PID，让转赠方用短信 OTP 确认金额。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。完成转账需要短信 OTP 确认，然后调用单独的执行接口。
- receiverMsisdn
- amount
- success
- message
- title
- PID
- nextAction
- data
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/transfers/initiate HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "receiverMsisdn": "7709876543",
  "amount": 5000.0
}
```
```
{
  "success": true,
  "message": "Confirm with OTP",
  "title": "Transfer credit",
  "PID": "pid-ct-44ab",
  "nextAction": "OTP",
  "data": null
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的话费转赠流程重构
- 返回的 PID 在转账执行前用短信 OTP 确认
列出叠加包
GET /v1/catalog/bundles opendata
返回用户浏览额外流量或语音包时展示的叠加包目录过滤器与包磁贴（title、price、validity）。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。
- success
- message
- data
- filter
- id
- title
- bodies
- price
- validity
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/catalog/bundles HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "data": {
    "filter": [
      {"id": "data", "title": "Data"},
      {"id": "voice", "title": "Voice"}
    ],
    "bodies": [
      {
        "title": "Weekly 2GB",
        "price": "3000 IQD",
        "validity": "7 days"
      }
    ]
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的叠加包目录重构
查询叠加包详情
GET /v1/catalog/bundles/{id} opendata
返回单个叠加包的价格、有效期、权益图标与订阅操作，用于包详情界面。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。
- success
- message
- data
- title
- price
- validity
- expiryTitle
- detail
- tags
- benefits
- icon
- postIcons
- links
- actionButtons
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/catalog/bundles/weekly-2gb HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "data": {
    "title": "Weekly 2GB",
    "price": "3000 IQD",
    "validity": "7 days",
    "expiryTitle": "Expires 7 days after activation",
    "detail": "2GB high-speed data, then 128 kbps",
    "tags": [{"title": "Data"}],
    "benefits": [
      {"icon": "data", "title": "2 GB", "postIcons": []}
    ],
    "links": [],
    "actionButtons": [{"title": "Subscribe"}]
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的包详情界面重构
获取 Shukran 忠诚度首页
GET /v2/rewards/home openfinance
加载 Shukran 忠诚度首页：剩余积分文案、兑换分区，以及按 id 发起兑换的操作。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。lang 查询参数选择 en/ar/ku 文案。
- success
- message
- data
- title
- subTitle
- sections
- actionButton
- detailSection
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v2/rewards/home?lang=en HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "data": {
    "title": "Shukran",
    "subTitle": "Your rewards",
    "message": "You have 420 points",
    "sections": [
      {"title": "Redeem", "points": 420}
    ],
    "actionButton": {"title": "Redeem now"},
    "detailSection": {"title": "How Shukran works"}
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的 Shukran 忠诚度首页重构
列出在用已订阅优惠
GET /v1/catalog/active opendata
返回线路上当前在用的叠加包——剩余量文本与有效期——供优惠管理 / 账户概览卡片使用。
认证方式： Authorization: Bearer accessToken，来自 OTP 确认调用。
- success
- message
- data
- bodies
- title
- balance
- validity
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/catalog/active HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "success": true,
  "message": "OK",
  "data": {
    "bodies": [
      {
        "title": "Weekly 2GB",
        "balance": "1.2 GB left",
        "validity": "Expires 03 Oct 2026"
      }
    ]
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的优惠管理与账户概览卡片重构

数据类别

余额
使用记录
用户资料
支付
账单
转账
忠诚度
叠加包

数据使用场景与案例

预付费余额与用量对账
夜间任务拉取 GET /v2/dashboard/home 与 GET /v1/billing/balance 获取 mainBalance / 剩余流量磁贴，再分页读取 GET /v1/usage/records，把语音与流量行（amount、unit、subTitle）与内部用量台账比对。
后付费账单缴纳与充值通道
支付运营控制台读取 GET /v1/billing/invoice（data + dueDate）与 GET /v1/billing/payment-methods（voucherPayment 与 onlinePayments 的 id/title），让客服在用户确认前报出正确的 FastPay 或 AsiaPay 通道。
话费转赠监控
家庭套餐工具调用 POST /v1/transfers/initiate 传入 receiverMsisdn 与 amount，保存返回的 PID，并在短信 OTP 后记录 success/message，让家庭话费转赠可审计。
叠加包目录与 Shukran 忠诚度
零售看板列出 GET /v1/catalog/bundles 叠加包（price、validity）与 GET /v1/catalog/active 的剩余量，并展示 GET /v2/rewards/home 的 sections，方便店员在实时线路旁讲解可兑换积分。

常见问题

Asiacell 如何对订阅者 API 调用进行认证？

POST /v1/auth/start 把 MSISDN 作为 username 发送，返回的 nextUrl 中带有 PID，连同短信验证码一起提交到 /v1/auth/verify。该调用返回 accessToken、refreshToken、userId、username、fullName 和 userType；后续请求发送 Authorization: Bearer 加该 accessToken。

哪些端点暴露预付费余额与用量？

GET /v2/dashboard/home 返回套餐名称、余额 / 流量磁贴和忠诚度 remain/total。GET /v1/billing/balance 返回 mainBalance 与币种。GET /v1/usage/records 分页返回 My Pocket 话单行，含 amount、unit、title、subTitle 和 description。

Asiacell 应用中的充值与缴账单如何工作？

GET /v1/billing/payment-methods 列出 voucherPayment 与 onlinePayments（FastPay、AsiaPay）。后付费线路先读 GET /v1/billing/invoice 获取未付金额与 dueDate，再通过支付 POST 完成缴费。

能看到叠加包和 Shukran 积分吗？

GET /v1/catalog/bundles 列出目录过滤器与叠加包磁贴；GET /v1/catalog/bundles/{id} 返回 price、validity 和 benefits。GET /v1/catalog/active 显示在用叠加包的剩余量。GET /v2/rewards/home?lang=en 是发起兑换的忠诚度首页。

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

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

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

获取报价

Asiacell 数据 API：余额、用量与充值

应用截图

API 端点一览

发起 MSISDN 登录并请求 OTP

确认短信 OTP 并签发会话

获取登录后的首页仪表盘

读取订阅者资料

列出使用记录

读取充值前的预付费主余额

查询后付费账单金额

列出充值支付方式

发起话费转赠

列出叠加包

查询叠加包详情

获取 Shukran 忠诚度首页

列出在用已订阅优惠

数据类别

数据使用场景与案例

预付费余额与用量对账

后付费账单缴纳与充值通道

话费转赠监控

叠加包目录与 Shukran 忠诚度

常见问题

更多电信类应用

hambi (Beeline Uzbekistan)

Mitra

相关主题

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

Asiacell 数据 API：余额、用量与充值

应用截图

API 端点一览

发起 MSISDN 登录并请求 OTP

确认短信 OTP 并签发会话

获取登录后的首页仪表盘

读取订阅者资料

列出使用记录

读取充值前的预付费主余额

查询后付费账单金额

列出充值支付方式

发起话费转赠

列出叠加包

查询叠加包详情

获取 Shukran 忠诚度首页

列出在用已订阅优惠

数据类别

数据使用场景与案例

预付费余额与用量对账

后付费账单缴纳与充值通道

话费转赠监控

叠加包目录与 Shukran 忠诚度

常见问题

相关应用

更多电信类应用

hambi (Beeline Uzbekistan)

Mitra

相关主题

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