getServiceNodeSystemReference
Request accessReturns the ID of the NDS.Live system that the service node belongs to. A system includes all the nodes that work together as one NDS.Live system.
Request data
HTTP method: POST
URL request format
https://{serviceURL}/getServiceNodeSystemReference?apiKey={Your_API_Key}serviceURLis your Smart Layer Tile Service endpoint, without/openapi.json.Your_API_Keyis a My.TomTom API key with NDS.Live services enabled.
Request body
This method takes no request body.
HTTP request headers
This method needs no request headers.
Response data
Response body
On success, the body is a zserio-encoded NdsSystemToken object with one field:
| Field | Description |
|---|---|
mapId | The UUID of the NDS.Live system. All nodes of the same system return the same ID. Services for different products return different IDs: for example, the ADAS and ISA evaluation services. |
This isn’t the service node’s own ID. The node ID is in the response of getServiceNodeLegalInfo.
HTTP response headers
This method doesn’t return an ETag, so it doesn’t support conditional requests.
HTTP status codes
Besides the codes below, any method can return the common errors, for example 401 for a missing API key.
| Code | Meaning |
|---|---|
200 | OK. The response body holds the NdsSystemToken. |
404 | Not found. |
410 | Gone. The Smart Layer Tile Service is decommissioned. Ask the NDS.Live Registry for another service. |
500 | Internal server error. |
Related resources
- Access and accounts: Your endpoints
getServiceNodeLegalInfo- Request and response patterns: Error messages