NODEDC_PLATFORM/packages/external-provider-contract/providers/gelios/v3/README.md

21 lines
1016 B
Markdown

# Gelios provider package v3
Version 3 describes the production REST transport used by the L2 workflow:
`GET https://api.geliospro.com/api/v1/units`. The provider credential keeps the
Gelios access/refresh pair inside native NDC L2 Credentials; n8n refreshes the
access token at request time and exposes neither secret to the graph. The
normalized output is the immutable provider-neutral Data Product
`fleet.positions.current.v2@2.0.0`.
The product adds four orthogonal state facets owned by L2 semantic mapping:
- `availability_state`: `online`, `offline`, `unknown`;
- `motion_state`: `moving`, `stationary`, `unknown`;
- `position_state`: `valid`, `low_quality`, `missing`;
- `freshness_state`: `fresh`, `stale`.
`state_policy_version` identifies the mapping policy that produced the facets.
`operational_status` remains in the product as a backwards-compatible coarse
state; presentation classes, colours, pin proportions and label geometry remain
Foundry-owned and are never part of this provider package.