Service manual · HTTPS / JSON

Device API

The ECOLINK device boundary for kiosk provisioning, runtime coordination, configuration delivery and authenticated device communication.

Capabilities

Device provisioning
Authenticated device sessions
Configuration bootstrap
Runtime heartbeat
Command acknowledgement
UI profile delivery

Service profile

Service ID: Ecolink.DeviceApi
Category: Managed Devices
Audience: Managed ECOLINK kiosks and authorized provisioning clients.
Protocol: HTTPS / JSON

Published interfaces

Method	Route / RPC	Purpose	Access
`POST`	`/api/v1/provisioning/kiosks/activate`	Activate and credential an approved kiosk installation.	Protected
`GET`	`/api/v1/devices/{deviceId}/bootstrap`	Retrieve configuration, license and effective UI profile.	Protected
`POST`	`/api/v1/devices/{deviceId}/heartbeat`	Submit device runtime health and operational state.	Protected
`POST`	`/api/v1/devices/{deviceId}/commands/{commandId}/ack`	Acknowledge the outcome of a queued device command.	Protected
`GET`	`/api/v1/kiosk/defaults`	Retrieve platform kiosk defaults used during device setup.	Service access

Standard service endpoints

/healthProcess health

/health/readyReadiness state

/api/meta/serviceMachine-readable service profile

Operational interfaces require the authentication and authorization policy assigned to the calling channel. Contract details remain versioned independently from the landing surface.