China Mobile

aid: china-mobile
url: https://raw.githubusercontent.com/api-evangelist/china-mobile/refs/heads/main/apis.yml
name: China Mobile
kind: company
description: China Mobile Limited is the world's largest mobile network operator by subscribers, serving approximately 1,005
  million mobile customers and 110 million gigabit broadband customers across all 31 provinces of mainland China plus Hong
  Kong, with roaming into more than 200 countries. Listed on the Hong Kong Stock Exchange and the Shanghai Stock Exchange
  and majority-owned by state-held China Mobile Communications Group, it runs mobile, broadband, cellular IoT, satellite internet,
  data centre, cloud and AI businesses on annual revenue of about RMB 1,050.2 billion. In the network-API value chain China
  Mobile sits squarely on the operator side, not the aggregator side. It joined the GSMA Open Gateway initiative in June 2023,
  sponsors and maintains several CAMARA APIs upstream (Click to Dial, the Model as a Service family, High-throughput Elastic
  Network, Facial Recognition, and co-sponsors Network Slice Booking), and in October 2024 secured GSMA Open Gateway certification
  for its Network-as-a-Service platform after its Quality on Demand API passed 63 conformance tests on ZTE NEF/SCEF exposure
  functions. None of that is callable from the open internet. Its API posture is partner-gated and domestic — the capability
  platforms at dev.10086.cn, ct.open.10086.cn and api.iot.10086.cn publish real product and interface documentation but issue
  credentials only to registered mainland enterprise customers under contract, and China Mobile is not a shareholder in Aduna,
  so it reaches developers through its own Chinese-language capability marketplaces rather than through the global CPaaS or
  aggregator channel. The one genuinely self-serve surface is OneNET, its IoT PaaS, which publishes open developer documentation
  and a live token-authenticated device API.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Telecommunications
- China
- Mobile Network Operator
- Network APIs
- CAMARA
- GSMA Open Gateway
- IoT
- 5G
- Broadband
- Quality on Demand
- Number Authentication
- Satellite
created: '2026-07-25'
modified: '2026-07-25'
specificationVersion: '0.19'
apis:
- aid: china-mobile:onenet-studio-application-api
  name: OneNET Studio Application API
  description: The OneNET Studio application API is the one China Mobile surface with a complete, anonymously readable request-and-response
    contract. It is an action-dispatched gateway — every call is https://openapi.heclouds.com/{namespace}?action={Action}&version=1,
    where the namespace is application (application development), common (device management), lwm2m-online or lwm2m-offline.
    Forty-four operations are documented across devices, products, projects, groups, thing models, device properties and desired
    properties, thing-model service invocation, device files and scene-linkage rules. Authentication is a signed, time-boxed
    authorization header (HMAC over et, method, res and version, signature algorithm version 2020-05-29). Every response is
    a uniform envelope carrying a platform-generated requestId, and business failures arrive as HTTP 200 with success false
    plus a string error code. China Mobile publishes no OpenAPI for it; the OpenAPI in this repository was transcribed operation
    by operation from the published reference, with each operation carrying its source page in x-evidence.
  humanURL: https://open.iot.10086.cn/doc/iot_platform/book/api/introduce.html
  baseURL: https://openapi.heclouds.com
  tags:
  - IoT
  - Device Management
  - Thing Model
  - PaaS
  - China
  properties:
  - type: OpenAPI
    url: openapi/china-mobile-onenet-studio-openapi.yml
  - type: Overlay
    url: overlays/china-mobile-onenet-studio-overlay.yaml
  - type: Documentation
    url: https://open.iot.10086.cn/doc/iot_platform/book/api/introduce.html
  - type: APIReference
    url: https://open.iot.10086.cn/doc/iot_platform/book/api/introduce.html
  - type: Authentication
    url: https://open.iot.10086.cn/doc/iot_platform/book/api/auth.html
  - type: ErrorCatalog
    url: https://open.iot.10086.cn/doc/iot_platform/book/api/code.html
  - type: SDKs
    url: https://open.iot.10086.cn/doc/iot_platform/book/api/sdk.html
  - type: DataModel
    url: data-model/china-mobile-data-model.yml
- aid: china-mobile:onenet-voice-call-service
  name: OneNET Voice Call Service (VCS) API
  description: 语音通话 (Voice Call Service) is China Mobile's publicly documented voice capability on the OneNET gateway, reached
    at https://openapi.heclouds.com/vcs?action={voiceNotify|dialNotify}&version=2. Click to dial (点击拨号) connects a caller
    and a callee across the China Mobile network; voice notification (语音通知) plays an approved TTS template to a subscriber
    and can collect DTMF digits. Both return a call_id and both deliver call-status callbacks to a caller-supplied notify_url,
    with documented status and disconnect-reason enumerations. Click to Dial is the domestic first-party product behind the
    CAMARA Click to Dial API that China Mobile sponsors upstream with Huawei — the shipped product does not implement the
    CAMARA schema or its OIDC/CIBA security model. Access is gated three ways — business entitlement, a test account pinned
    to an approved source IP, and a trial-usage quota. Service numbers and TTS templates require qualification review before
    use.
  humanURL: https://open.iot.10086.cn/doc/iot_platform/book/vcs/vcs_api/request.html
  baseURL: https://openapi.heclouds.com
  tags:
  - Voice
  - Click to Dial
  - CAMARA
  - Network APIs
  - China
  properties:
  - type: OpenAPI
    url: openapi/china-mobile-vcs-openapi.yml
  - type: Overlay
    url: overlays/china-mobile-vcs-overlay.yaml
  - type: Documentation
    url: https://open.iot.10086.cn/doc/iot_platform/book/vcs/vcs_api/request.html
  - type: APIReference
    url: https://open.iot.10086.cn/doc/iot_platform/book/vcs/vcs_api/ctd.html
  - type: ErrorCatalog
    url: https://open.iot.10086.cn/doc/iot_platform/book/vcs/vcs_api/errorcode.html
  - type: Webhooks
    url: https://open.iot.10086.cn/doc/iot_platform/book/vcs/vcs_api/ctd-status.html
  - type: TermsOfService
    url: https://open.iot.10086.cn/doc/iot_platform/book/agreement/vcs-service-agreement.html
- aid: china-mobile:onenet-iot-platform
  name: OneNET IoT Open Platform API
  description: OneNET is China Mobile's IoT PaaS, operated by its CMIOT subsidiary, for device connection, device management,
    data storage and data visualisation. It is the company's most genuinely developer-facing surface, with open Chinese-language
    documentation covering MQTT and multi-protocol device access, OneNET Studio, edge computing, device management (DMP),
    OTA, message queue, SMS, LBS and video capabilities. The legacy REST base URL api.heclouds.com is live and responds with
    a JSON token authentication error to unauthenticated calls, confirming a real token-authenticated device API behind the
    docs.
  humanURL: https://open.iot.10086.cn/doc/
  baseURL: https://api.heclouds.com
  tags:
  - IoT
  - Device Management
  - MQTT
  - PaaS
  - China
  properties:
  - type: Documentation
    url: https://open.iot.10086.cn/doc/
  - type: APIReference
    url: https://open.iot.10086.cn/doc/iot_platform/
  - type: Documentation
    url: https://open.iot.10086.cn/doc/mqtt
  - type: Portal
    url: https://open.iot.10086.cn/
- aid: china-mobile:iot-card-capability-platform
  name: China Mobile IoT Card Capability Open Platform API
  description: The 物联卡能力开放平台 (IoT Card Capability Open Platform) exposes cellular M2M SIM lifecycle and subscriber-information
    operations to enterprise IoT customers. Interface documentation is published openly — the confirmed CMIOT_API2003 码号信息查询
    (code/number information query) page documents GET/POST https://api.iot.10086.cn/v2/cardinfo, which resolves any one of
    ICCID, IMSI or MSISDN into the other two. Authentication is a proprietary signed-request scheme (appid, transid, ebid
    and a SHA-256 token derived from appid+password+transid) whose credentials China Mobile issues by email to approved enterprise
    IoT-card customers only. No OpenAPI is published.
  humanURL: https://api.iot.10086.cn/apiDocuments/cusInfo/codeInfoQuery.html
  baseURL: https://api.iot.10086.cn/v2
  tags:
  - IoT
  - M2M
  - SIM Management
  - Connectivity Management
  - China
  properties:
  - type: Documentation
    url: https://api.iot.10086.cn/
  - type: APIReference
    url: https://api.iot.10086.cn/apiDocuments/cusInfo/codeInfoQuery.html
- aid: china-mobile:communication-capability-platform
  name: China Mobile Communication Capability Open Platform
  description: The 通信能力开放平台 (Communication Capability Open Platform) is China Mobile's commercial network-capability channel
    and the surface where its Open Gateway work actually meets buyers. Its published developer guide lists audio/video products
    — 语音通知 (voice notification), 语音验证码 (voice OTP), 点击拨号 (click to dial) and 中间号 (number masking / privacy number) — plus
    an intelligent-pipe product, QoS保障 (QoS guarantee). Click to Dial and QoS map directly to the CAMARA Click to Dial and
    Quality on Demand APIs that China Mobile sponsors upstream. The guide covers product introduction, quick start, interface
    guidance and pricing, but ordering and credentials require enterprise onboarding; no base URL, endpoint reference or machine-readable
    definition is published anonymously.
  humanURL: https://ct.open.10086.cn/portal/developer/docAndHelp.action
  tags:
  - Voice
  - Click to Dial
  - Number Masking
  - Quality on Demand
  - Network APIs
  - China
  properties:
  - type: Documentation
    url: https://ct.open.10086.cn/portal/developer/docAndHelp.action
  - type: Portal
    url: https://ct.open.10086.cn/portal/index.action
- aid: china-mobile:internet-capability-open-platform
  name: China Mobile Internet Capability Open Platform
  description: 中国移动互联网能力开放平台 at dev.10086.cn is the operator's application-facing capability marketplace, describing itself
    as offering 移动认证/号码认证 (mobile and number authentication), 大数据服务 (big data services), 通信能力 (communication capabilities),
    支付能力 (payment/carrier-billing capabilities) and promotion capabilities. In practice it is an enterprise procurement console
    rather than a developer portal — its routes are login, ability ordering, application management, billing, invoices and
    work orders, and every documentation route resolves to the same single-page shell for anonymous visitors. Its number-authentication
    capability is the domestic analogue of CAMARA Number Verification and is delivered through China Mobile's CMPassport unified-authentication
    gateway rather than through a CAMARA endpoint.
  humanURL: https://dev.10086.cn/
  tags:
  - Number Authentication
  - Identity Verification
  - Carrier Billing
  - Big Data
  - Messaging
  - China
  properties:
  - type: Documentation
    url: https://dev.10086.cn/
  - type: Portal
    url: https://dev.10086.cn/apmc/abilityList
common:
- type: Website
  url: https://www.chinamobileltd.com/
- type: DeveloperPortal
  url: https://open.iot.10086.cn/
- type: Portal
  url: https://dev.10086.cn/
- type: Documentation
  url: https://open.iot.10086.cn/doc/
- type: APIReference
  url: https://open.iot.10086.cn/doc/iot_platform/book/api/introduce.html
- type: GettingStarted
  url: https://open.iot.10086.cn/doc/easy-manual
- type: Support
  url: https://open.iot.10086.cn/servicesupport/workorder/list
- type: HelpCenter
  url: https://open.iot.10086.cn/doc/problem
- type: Pricing
  url: https://open.iot.10086.cn/doc/introduce/book/fee.html
- type: SignUp
  url: https://open.iot.10086.cn/login
- type: TermsOfService
  url: https://open.iot.10086.cn/about/serviceprot/
- type: Console
  url: https://open.iot.10086.cn/console
- type: GitHubOrganization
  url: https://github.com/cmri
- type: SourceCode
  url: https://github.com/cm-heclouds
- type: ChangeLog
  url: https://open.iot.10086.cn/doc/iot_platform/book/release/update_log.html
- type: AgenticAccess
  url: agentic-access/china-mobile-agentic-access.yml
- type: DomainSecurity
  url: security/china-mobile-domain-security.yml
- type: Authentication
  url: authentication/china-mobile-authentication.yml
- type: Packages
  url: packages/china-mobile-packages.yml
- type: SDKs
  url: packages/china-mobile-packages.yml
- type: Conventions
  url: conventions/china-mobile-conventions.yml
- type: ErrorCatalog
  url: errors/china-mobile-error-codes.yml
- type: Lifecycle
  url: lifecycle/china-mobile-lifecycle.yml
- type: ChangeLog
  url: changelog/china-mobile-changelog.yml
- type: Conformance
  url: conformance/china-mobile-conformance.yml
- type: Sandbox
  url: sandbox/china-mobile-sandbox.yml
- type: DataModel
  url: data-model/china-mobile-data-model.yml
- type: AsyncAPI
  url: asyncapi/china-mobile-onenet-asyncapi.yml
- type: Webhooks
  url: asyncapi/china-mobile-onenet-webhooks.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/china-mobile-llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com