Update Consent Request

As a Marketplace consumer, you can connect with new customers on the current subscription or end the partnership. It is possible via Consent Manager editing functionality. You can add or remove VIN(s) from a consent request. You can also create a consent request without VIN(s) via Consent Management API. When you create or edit an existing consent request, upload one CSV or JSON format file of maximum 2 MB with a list of VIN(s) you want to add.

See a detailed description of how to add and remove VIN(s) using the Consent Management API endpoints below.

To update the consent request status you need to obtain credentials and authenticate with HERE platform. For more information, see Get Access to HERE Marketplace.

Get HERE platform APIs

Use api-lookup service to get the base URLs of all HERE platform APIs. HERE platform APIs are those that are not tied to a specific catalog. To get a list of all HERE platform APIs, make this request:

GET /lookup/v1/platform/apis HTTP/1.1
Host: api-lookup.data.api.platform.here.com
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET \
     -H "Authorization: Bearer <Authorization Token>" \
     -H "Cache-Control: no-cache" \
     https://api-lookup.data.api.platform.here.com/lookup/v1/platform/apis

The response includes a list of HERE platform APIs that you have access to, including their base URLs.

You can also use api-lookup service to get the base URL for the Consent Management API. Make the following request:

GET /lookup/v1/platform/apis/consent/v1 HTTP/1.1
Host: api-lookup.data.api.platform.here.com
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET \
     -H "Authorization: Bearer <Authorization Token>" \
     -H "Cache-Control: no-cache" \
     https://api-lookup.data.api.platform.here.com/lookup/v1/platform/apis/consent/v1

In case of a successful run, you receive the following response:

  {
    "api": "consent",
    "version": "v1",
    "baseURL": "https://consent.api.platform.here.com/consent-service/v1",
    "parameters": {}
  }

For more information about api-lookup API, see API Lookup Developer's Guide.

Add new VIN(s) to a consent request

To add VIN(s) to existing consent request, make the following request:

https://dev.consent.api.platform.in.here.com/consent-service/v1/consentRequests/consent-request-id-example/addDataSubjects
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X PUT \
     -H "Authorization: Bearer <Authorization Token>" \
     -H "Cache-Control: no-cache" \
     -H "Accept: */*" \
     -H "Content-Type: multipart/form-data" \
     -d {"vins":{}} \
     "https://dev.consent.api.platform.in.here.com/consent-service/v1/consentRequests/consent-request-id-example/addDataSubjects"

Delete all non-approved VIN(s) from a JSON or CSV file

To delete all non-approved VIN(s) from a JSON or CSV file, make the following request:

curl -X PUT \
     -H "Authorization: Bearer <Authorization Token>" \
     -H "Cache-Control: no-cache" \
	-H "accept: application/json" \
	-H "Content-Type: multipart/form-data"\
	-d {"vins":{}}	\
	"https://dev.consent.api.platform.in.here.com/consent-service/v1/consentRequests/consent-request-id-example/removeDataSubjectsExceptApproved"

Delete all VIN(s) from a JSON or CSV file

To delete all VIN(s) from a JSON or CSV file, make the following request:

curl -X PUT \
     -H "Authorization: Bearer <Authorization Token>" \
     -H "Cache-Control: no-cache" \
	-H "accept: */*" \
	-H "Content-Type: multipart/form-data" \
	-d {"vins":{}}\
	"https://dev.consent.api.platform.in.here.com/consent-service/v1/consentRequests/consent-request-id-example/removeAllDataSubjects"