v1

latestOpenAPI 3.0.12026-07-24110189356.6 KB
ingestion

Endpoint for ingesting generic data

Sends streaming data to a specified layer in the HERE platform

post/layers/{layerId}

Path parameters

layerIdstring required

The ID of the layer where you want the data ingested.

Query parameters

billingTagstring

Optional billing tag provided by customer. It will be used in grouping of billing records.

Headers

X-HERE-Checksumstring

A base64 encoded SHA-256 hash you can provide for validation against the calculated value on the request body hash. This verifies the integrity of your request and prevents modification by a third party.It will be created by the service if not provided. A SHA-256 hash consists of 256 bits or 64 chars.

X-HERE-TraceIdstring

A unique message ID, such as a UUID. This can be included in the request if you want to use an ID that you define. If you do not include an ID, one will be generated during ingestion and included in the response. You can use this ID to track your request and identify the message in the catalog.

X-HERE-Message-Keystring

A unique message ID, such as a UUID. This can be included in the request if you want to use an ID that you define. If you do not include an ID, X-HERE-TraceId will be used instead. You can use this ID to specify the partition for the message in the data catalog.

Response

OK

traceIdstring

A unique ID for the message. This can be a user-defined trace ID included in the request. If a trace ID was not included in the request, one is generated during ingestion and included in the response. You can use this ID to track your request and identify the message in the catalog.

Example response

{
  "traceId": "cb72fb52-9efa-11e7-abc4-cec278b6b50a"
}