Map Feedback API Developer's Guide

HTTP Request Headers

The Map Feedback API uses HTTP Request Headers for authentication credentials and content settings for requests.

The following section explains each of the headers in detail.

Table 1. Headers
Header Name Description
Accept Specifies which media types are acceptable for the response (see Accept header specification ).
  • For feedback submission requests: application/vnd.here.layerObjectList+json
  • For feedback status requests: application/json
Accept-Charset Sets the character set used in the response. Default: UTF-8.
Auth-Service-Id Specifies the application associated with the Map Feedback API.

here_app indicates the feedback is for your application.

If you are using the Map Feedback API with another application, consult your HERE customer representative for the appropriate value.

Auth-Identifier Header to put in the fixed string "apikey", if you want to choose the apikey authentication mechanism. If you want to do use the deprecated app_id/app_code authentication, you need to put in here your own app_id.
Auth-Secret Header to put in your own apikey in case you want to choose the apikey authentication mechanism. If you want to do use the deprecated app_id/app_code authentication, you need to put in here your own app_code.
Content-Type Specifies the media type of the body in POST requests.

Must be: application/vnd.here.layerObjectList+json; charset=UTF-8.

Content Disposition For new feedback submission requests: form-data; name=-"file";filename="myFile.png"

application/vnd.here.layerObjectList+json; charset=UTF-8.

For submitting new feedback: form-data; name="feedback"

For submitting an attachment for existing feedback: multipart/form-data, boundary="RANDOM_DELIMITER"

If you need to manage limitations caused by the cross-origin domain sharing (CORS) mechanism, you can set the header parameters as part of the URL. If you do so, the URL must contain the parameter CORSH. Its value must be a JSON encoded String of the headers object. The HTTP header is overwritten in this case.

http://host/path?CORSH=encodeURIComponent(JSON.stringify( {
"Content-Type": "application/vnd.here.layerObjectList+json; charset=utf-8",
"Accept": "application/json; charset=UTF-8",
"GroupId": "FGx1AWaAzKOo0imNkLmf",
"AuthServiceId": "here_app",
"Auth-Identifier": "<put your app id here>",
  "Auth-Secret": "<put your app code/token here>"
    } ) )