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

ASIACELL COMMUNICATIONS PJSC · 电信

Asiacell 是伊拉克移动运营商 ASIACELL COMMUNICATIONS PJSC 的官方自助服务应用，供预付费和后付费用户在手机上打理自己的号码。登录使用手机号加短信一次性验证码，必要时辅以图形验证码；首页直接呈现当前套餐名称、余额与剩余流量磁贴，以及带到期日的 Shukran 忠诚度积分。充值页显示以伊拉克第纳尔计的主余额和有效期说明，可用刮刮卡或 FastPay、AsiaPay 等在线钱包充值；后付费用户能查看未缴账单金额与截止日期并在应用内缴费；My Pocket 在短信验证码确认后列出逐条的语音、流量与短信使用明细。用户还可以向其他 Asiacell 号码转赠话费（以短信验证码确认）、按类型筛选浏览叠加流量包和语音包，在订阅前查看每个包的价格、有效期与权益，跟踪在用优惠的剩余量与到期时间，兑换 Shukran 积分，并维护含姓名、邮箱和头像的个人资料；应用界面提供英语、阿拉伯语和库尔德语。它服务于伊拉克全国的移动用户，在当地与 Zain Iraq 的用户应用，以及总部位于埃尔比勒、主攻库尔德斯坦地区的 Korek Telecom 旗下 MyKorek 同台竞争。

Shukran 忠诚度积分、My Pocket 话单记录，以及以伊拉克第纳尔计的主余额，构成了每条登录的 Asiacell 线路背后的账户数据。每个会话解析为数字 userId、作为 MSISDN 的 username、用户 fullName，以及区分预付费（PREPAID）与后付费线路的 userType 标记；资料页再补充 firstName、lastName、thirdName、email 与 photo。资金一侧包括预付费 mainBalance 及其 currency 与有效期 note、以金额加 dueDate 表示的未缴后付费账单，以及充值时可选的通道：刮刮卡 voucherPayment 与 FastPay、AsiaPay 等 onlinePayments 钱包，每个钱包带 id 和 selected 标记。

用量以分页的 My Pocket 话单行呈现：每行含 amount、unit（语音扣费为 IQD，流量会话为 MB）、标明业务的 title、对方号码 subTitle，以及记录通话时长与时间戳的 description，并附 total 与 page 计数。首页数据提供当前 plan 名称和余额 / 流量 points 磁贴；话费转赠记录 receiverMsisdn、amount 与确认用的 PID；叠加包目录列出带 price、validity、benefits 与 expiryTitle 的包，在用优惠报告剩余 balance；Shukran loyaltyPoint 区块以 remain 对比 total，并给出 expiration 日期和 registered 标记。

这些数据流入夜间预付费对账任务，把余额磁贴与话单行同内部用量台账逐条比对；流入支付运营控制台，读取账单金额与截止日期，在用户确认前报出正确的 FastPay 或 AsiaPay 通道；流入家庭套餐工具，在短信确认后记录每笔话费转赠的接收号码、金额与结果，让家庭内部转赠有据可查；也流入零售看板，让门店员工在线路旁展示在用叠加包余量与可兑换的 Shukran 积分。openData Studio 将这些 Asiacell 订阅者数据变成可调用的开放数据，让上述团队直接集成，而不必逐屏读取。

应用截图

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"
}
```
确认短信 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"
}
```

获取登录后的首页仪表盘

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/subscriber/profile osint

加载已认证订阅者的法定姓名分段、MSISDN、邮箱与头像，展示在账户 / 资料界面。

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

success
message
title
nextAction
data
firstName
lastName
thirdName
phone
email
photo

GET /v1/subscriber/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
  }
}

读取充值前的预付费主余额
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
}
```

列出叠加包

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"}
  }
}

列出在用已订阅优惠
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 是发起兑换的忠诚度首页。

与 Asiacell 相似的应用

Zain Iraq — Zain Iraq 的官方应用让这家伊拉克移动运营商的用户管理号码：查询余额、充值、支付账单以及在预付费号码之间转账。
MyKorek — MyKorek 是伊拉克移动运营商 Korek Telecom 的用户应用，该公司总部位于埃尔比勒，主要服务库尔德斯坦地区。
Alwatani — Alwatani 是伊拉克互联网服务商 Earthlink 的应用，面向其光纤到户宽带用户。
hambi (Beeline Uzbekistan) — hambi 是乌兹别克斯坦运营商 Beeline Uzbekistan 的超级应用，将移动账户与套餐管理和日常数字服务集于一体。

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

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

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

获取报价

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

应用截图

API 端点一览

发起 MSISDN 登录并请求 OTP

确认短信 OTP 并签发会话

获取登录后的首页仪表盘

读取订阅者资料

列出使用记录

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

查询后付费账单金额

列出充值支付方式

发起话费转赠

列出叠加包

查询叠加包详情

获取 Shukran 忠诚度首页

列出在用已订阅优惠

数据类别

数据使用场景与案例

预付费余额与用量对账

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

话费转赠监控

叠加包目录与 Shukran 忠诚度

常见问题

与 Asiacell 相似的应用

更多电信类应用

Hathway Broadband

Mi Movistar Chile

Minha Vero

Mitra

相关主题

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

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

应用截图

API 端点一览

发起 MSISDN 登录并请求 OTP

确认短信 OTP 并签发会话

获取登录后的首页仪表盘

读取订阅者资料

列出使用记录

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

查询后付费账单金额

列出充值支付方式

发起话费转赠

列出叠加包

查询叠加包详情

获取 Shukran 忠诚度首页

列出在用已订阅优惠

数据类别

数据使用场景与案例

预付费余额与用量对账

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

话费转赠监控

叠加包目录与 Shukran 忠诚度

常见问题

相关应用

与 Asiacell 相似的应用

更多电信类应用

Hathway Broadband

Mi Movistar Chile

Minha Vero

Mitra

相关主题

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