# China Mobile

> China Mobile Limited is the world's largest mobile network operator by subscribers — about 1,005 million mobile customers and 110 million gigabit broadband customers across all 31 provinces of mainland China plus Hong Kong. In the network-API value chain it sits on the operator side: a GSMA Open Gateway member since June 2023, the sponsor of nine CAMARA APIs, and the holder of a GSMA Open Gateway certification for its Network-as-a-Service platform. Almost none of that is callable from the open internet. Its self-serve, publicly documented API surface is OneNET, the IoT platform operated by its CMIOT subsidiary.

Generated by API Evangelist on 2026-07-25 from the artifacts in this repository. China Mobile publishes no llms.txt of its own (probed: open.iot.10086.cn, api.iot.10086.cn, dev.10086.cn, www.chinamobileltd.com — all miss).

## What is actually callable

- [OneNET Studio application API](https://open.iot.10086.cn/doc/iot_platform/book/api/introduce.html): action-dispatched gateway at `https://openapi.heclouds.com/{namespace}?action={Action}&version=1`. Namespaces `application`, `common`, `lwm2m-online`, `lwm2m-offline`. 44 operations documented — devices, products, projects, groups, thing models, properties, services, files, scene-linkage rules.
- [OneNET Voice Call Service](https://open.iot.10086.cn/doc/iot_platform/book/vcs/vcs_api/request.html): `https://openapi.heclouds.com/vcs?action={voiceNotify|dialNotify}&version=2`. Click to dial and TTS voice notification, with call-status callbacks. This is the first-party product behind the CAMARA Click to Dial API China Mobile sponsors.
- [OneNET legacy device cloud API](https://open.iot.10086.cn/doc/multiprotocol/): `https://api.heclouds.com` — live, token-authenticated, `{"errno":3,"error":"token鉴权失败"}` to anonymous callers.
- [IoT Card Capability Open Platform](https://api.iot.10086.cn/apiDocuments/cusInfo/codeInfoQuery.html): `https://api.iot.10086.cn/v2/cardinfo` (CMIOT_API2003) resolves ICCID, IMSI or MSISDN into the other two. Credentials issued by email to approved enterprise IoT-card customers only.

## What is documented but gated

- [Communication Capability Open Platform](https://ct.open.10086.cn/portal/developer/docAndHelp.action): 语音通知, 语音验证码, 点击拨号, 中间号 (number masking), QoS保障. Products named, no anonymous endpoint reference.
- [Internet Capability Open Platform](https://dev.10086.cn/): 移动认证/号码认证 (number authentication via CMPassport), 大数据服务, 通信能力, 支付能力. An enterprise procurement console, not a developer portal.

## Specs

- [OneNET Studio application API OpenAPI 3.1](openapi/china-mobile-onenet-studio-openapi.yml) — 44 operations, derived from the published reference, every operation carrying x-evidence
- [OneNET Voice Call Service OpenAPI 3.1](openapi/china-mobile-vcs-openapi.yml) — 2 actions plus 2 webhook callbacks
- [OneNET event surface AsyncAPI 3.0](asyncapi/china-mobile-onenet-asyncapi.yml) — HTTP data push, push-instance validation, VCS call-status callbacks

## Contract artifacts

- [Authentication](authentication/china-mobile-authentication.yml) — signed `authorization` header, HMAC over `et\nmethod\nres\nversion`, version `2020-05-29`
- [Conventions](conventions/china-mobile-conventions.yml) — action-in-query dispatch, uniform envelope, `requestId` tracing, no idempotency, no published rate limits
- [Error codes](errors/china-mobile-error-codes.yml) — 4 envelope shapes, 30 platform codes, 23 voice codes, 15 callback acknowledgement codes
- [Webhooks](asyncapi/china-mobile-onenet-webhooks.yml) — validation handshake, signature, AES secure mode, 16-attempt exponential-backoff retry over 2h45m
- [Data model](data-model/china-mobile-data-model.yml) — project / product / device / group / thing model / call
- [Lifecycle](lifecycle/china-mobile-lifecycle.yml) — query-parameter versioning, no deprecation policy, no SLA, no status page
- [Changelog](changelog/china-mobile-changelog.yml) — OneNET Studio release log, current v1.1.9 (2021-03-25)
- [Sandbox](sandbox/china-mobile-sandbox.yml) — gated test accounts pinned to an IP allowlist; no published test values
- [Conformance](conformance/china-mobile-conformance.yml) — GSMA Open Gateway certified, nine CAMARA APIs sponsored; no OAuth2, OIDC, CIBA, RFC 9457, RFC 9116 or RFC 8594
- [Domain security](security/china-mobile-domain-security.yml) — TLS and HSTS per host, no DNSSEC, no CAA, no SPF, no DMARC
- [Well-known](well-known/china-mobile-well-known.yml) — nothing published on any host
- [Agentic access](agentic-access/china-mobile-agentic-access.yml) — recommended execution contracts for all 45 operations

## SDKs

First-party client libraries live at [github.com/cm-heclouds](https://github.com/cm-heclouds) (CMIOT, 38 repositories) — Java, Node, C, C#, PHP, Go, Android, iOS, Arduino, JavaScript, NB-IoT. Only the Java SDK reaches a package registry, on Maven Central under `com.github.cm-heclouds`. Full inventory: [packages](packages/china-mobile-packages.yml).

## Agent skills

- [Onboard and authenticate](skills/china-mobile-onboard-and-authenticate.md)
- [Register and control a device](skills/china-mobile-register-and-control-a-device.md)
- [Receive device events over HTTP data push](skills/china-mobile-receive-device-events.md)
- [Place a click-to-dial or voice-notification call](skills/china-mobile-place-a-click-to-dial-call.md)

## Things an agent should know before calling

- Every response is **HTTP 200**. Branch on the `success` field, never on the status code.
- There is **no idempotency key** anywhere in the estate. Retrying `CallService`, `dialNotify` or `voiceNotify` re-executes — the voice actions place a second billable telephone call.
- There are **no published rate limits**, no 429 semantics, and no status page.
- The console and all documentation are **Chinese-language**, and full entitlement requires 实名认证 (real-name verification). Everything outside OneNET requires an enterprise contract and manually issued credentials.
- China Mobile is **not** an Aduna shareholder; it reaches developers through its own domestic capability marketplaces rather than the global aggregator channel.

## Support

- Documentation: https://open.iot.10086.cn/doc/
- FAQ: https://open.iot.10086.cn/doc/problem
- Announcements: https://open.iot.10086.cn/doc/announcement
- Email: iot_service@cmiot.chinamobile.com
- Phone: 4001-100-868 转 3