Get operator presence
getOperatorPresencePermiso read
Which «operarios» have a tablet connected right now, and whether the app is open on it. An «operario» missing from the answer is offline.
/v1/external/organizations/{organizationId}/operators/presenceAnswers the connection dot each «puesto» card of the «Tablero en tiempo real» wears: one row per «operario» whose tablet is connected to Fluenta right now, with state active («En la app»: the app is open on the screen) or background («Fuera de la app o pantalla bloqueada»: connected, the app out of sight).
An «operario» missing from operators is offline («Sin conexión»): there is no offline row, and an organization with no tablet connected answers operators: []. Rows are ordered by operatorId, an id of listOperators; to name them or find their «puesto», join with listOperators or call getOperator.
at is the instant the tablets were read, ISO 8601 in UTC (the one field here that is not on the plant’s clock). It is a snapshot, never stored: ask again to see a change. Presence says a tablet is connected, not that units are being made: for that read unitsThisHour on the «puesto».
Not paged: the whole answer comes in one response.
Plan: on every plan, Light included. A «token de API» reads it in any organization the user who created it belongs to; a connected AI app (a «conexión») reads it only where the organization has «Conectar con IA» (getPlan.features.aiConnector, a Pro feature), and answers 403 PLAN_LIMIT elsewhere.
Rate limit: one request of the credential’s ordinary budget in this organization (getPlan answers the numbers); past it, 429 RATE_LIMITED with Retry-After in seconds.
Autorización
apiToken An API token created in Configuración › Tokens de API, or a connected app’s access token
En: header
Parámetros de ruta
The organization, from getMe or listOrganizations.
Respuestas
application/json
application/json
curl -X GET "https://api.fluenta.io/v1/external/organizations/0/operators/presence" \ -H "Authorization: Bearer fluenta_live_XXXX"{ "at": "2019-08-24T14:15:22Z", "operators": [ { "operatorId": 0, "state": "active" } ]}