# RONIQ integration examples 1.1.6

All IDs, measurements, timestamps and responses are synthetic. No account, token, customer data or live endpoint is included. The OpenAPI is an explicit six-operation extract of docs/api/openapi.yaml, SHA-256 ab41dd6bd8e19bb94613f19aaa9319fb639ba546368f37a6784a1a9eea67ebc6. Files in manifest.json are checked against their byte hashes.

## Offline samples

Validate states.request.json against $defs.StateBatch in messages.schema.json. rawPayload.body decodes to {"robotId":"AMR-031","batterySoc":48}; sha256 covers those exact UTF-8 bytes. Receipt variants show alternatives, not a single request becoming both COMPLETED and FAILED. FAILED is a processing outcome; its successful lookup still uses success:true. No new prediction API is provided.

## Before sending

Agree a test environment and repository access with your operator. The public files provide no account, sandbox or source-code package. An authorized operator must register customer/site, Connector, service credential, source kind/generation and robotExternalId. Agent sources[] does not register a server Source. Map mappingVersion/sourceGeneration to current registration. Register components through existing UserBearer asset permissions separately. Replace the fixed observedAt with the actual UTC measurement timestamp before the first transmission; do not change a replay body or event identity. Ingestion requires a client_credentials service token; robot state reads require a scoped user token.

## Repository-root Docker example

Public downloads are contract and configuration examples, not a standalone runnable package. Obtain authorized access to the RONIQ repository from your operator; no public repository access is granted by these files. Docker and tools/simulator source are required for Compose, and apps/site-agent source is required to build the Agent. Run from that repository root with port 18081 unused. The example starts only a local synthetic OEM, not a Core sandbox or a verified manufacturer connection. Copy and download do not execute an API or issue credentials.

    docker compose --project-directory . -f apps/web/public/integration/1.1.6/compose.synthetic.yaml config --quiet
    docker compose --project-directory . -f apps/web/public/integration/1.1.6/compose.synthetic.yaml up --build simulator
    curl http://127.0.0.1:18081/vendor/atlas/states
    docker build -t roniq-site-agent:local apps/site-agent

The downloadable agent.example.json shows valid settings using a non-resolving OEM placeholder. Match fields to actual OEM output; the Atlas simulator has its own mapping. To generate all 12 repository simulator mappings, install the locked Agent dependencies in an isolated environment, set PYTHONPATH=tools/simulator, and run:

    python -m simulator.agent_config --help
    python -m simulator.agent_config --output <LOCAL_AGENT_JSON> --agent-id <REGISTERED_AGENT_ID> --tenant-id <REGISTERED_TENANT_ID> --customer-id <REGISTERED_CUSTOMER_ID> --site-id <REGISTERED_SITE_ID> --connector-id <REGISTERED_CONNECTOR_ID>

The generated 12-source configuration also requires a separately configured MQTT broker. Agent execution further needs privately mounted spool key, client secret, API/OIDC test URLs and volume permissions for UID10001. This guide does not generate credentials or call the internal stack bootstrap. Public API host/OIDC token endpoint are intentionally absent; use the operator-assigned local test gateway.
