Guides
Guides

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.

Header NameDescription
AcceptSpecifies which media types are acceptable for the response (see Accept header specification). For feedback submission requests, use application/vnd.here.layerObjectList+json. For feedback status requests, use application/json
Accept-CharsetSets the character set used in the response. Default: UTF-8.
Auth-Service-IdSpecifies 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-IdentifierHeader 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-SecretHeader 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-TypeSpecifies the media type of the body in POST requests. Must be: application/vnd.here.layerObjectList+json; charset=UTF-8.
Content DispositionFor new feedback submission requests, use 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": "apikey",
    "Auth-Secret": "<put your apikey>"
        } ) )