Resolve a Metasys fully qualified reference (FQR) to an object id and read a point's present value

Documented steps

1. Authenticate and obtain a Bearer token from POST /api/v6/login.
2. URL-encode the FQR (item reference) exactly as it appears in Metasys, e.g. 'oas:oas/Programming.AV3' becomes 'oas%3Aoas%2FProgramming.AV3'. Colons and slashes must be escaped by the client.
3. GET {base}/objects/identifiers?fqr={encodedFqr}. The response body is a bare JSON string containing the object GUID - it is not wrapped in an envelope, so parse it as a scalar.
4. Read one attribute with GET {base}/objects/{objectId}/attributes/{attributeId}, e.g. attributeId 'presentValue'. Short attribute names are accepted in the path.
5. Parse the response: {"item":{...only the requested attribute...},"condition":{...},"schema":{...optional...}}. Add ?includeSchema=true only when you need the JSON schema - it materially enlarges the payload.
6. Inspect 'condition' for per-attribute reliability and current write priority before trusting the value; a value present with an unreliable condition is stale or faulted.
7. To retrieve a group of attributes in one call instead, GET {base}/objects/{objectId}?viewId={view}. The response envelope includes self, objectType, item, views, effectivePermissions {canDelete, canModify}, plus relationship URLs (parentUrl, objectsUrl, pointsUrl, trendedAttributesUrl, alarmsUrl, auditsUrl).
8. To discover which attributes exist without pulling values, GET {base}/objects/{objectId}/attributes?attributeFilter=basic (enum: all (default), basic, writableBasic, prioritizedBasic). This returns schema only - the default attribute is the sole value returned.
9. Reference: https://jci-metasys.github.io/api-landing/api/v6-16 (Metasys REST API, 'Version 6 for 16.0', OpenAPI 3.0.3). Doc set index: https://jci-metasys.github.io/api-landing/ | changelog: https://jci-metasys.github.io/api-landing/guides/api-changelog/ | version support: https://jci-metasys.github.io/api-landing/guides/version-support-matrix/ | polling and streaming limits: https://jci-metasys.github.io/api-landing/guides/attribute-access-guidelines/