承諾リクエストを更新します

マーケットプレイスのコンシューマーは、現在のサブスクリプションで新しい顧客と接続するか、またはパートナーシップを終了できます。 承諾管理者の編集機能を使用して編集できます。 承諾リクエストに VIN を追加または削除できます。 承諾管理 API を使用して、 VIN を使用せずに承諾リクエストを作成することもできます。既存の承諾リクエストを作成または編集する場合は、追加する VIN のリストとともに、最大 2 MB の csv または JSON 形式のファイルを 1 つアップロードします。

以下の承諾管理 API エンドポイントを使用して VIN を追加および削除する方法の詳細な説明を参照してください。

承諾リクエストのステータスを更新するには、資格情報を取得して HERE platform で認証する必要があります。 詳細について は、「 HERE Marketplace へのアクセス権を取得」を参照してください。

HERE platform API を取得します

api-lookup サービスを使用して、すべての HERE platform API のベース URL を取得します。 HERE platform API は、特定のカタログに関連付けられていない API です。 すべての HERE platform API のリストを取得するには、次のリクエストを作成します。

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

応答には、アクセス権を持つ HERE platform API のリストが含まれています。このリストには、ベース URL も含まれています。

api-lookup サービスを使用して、承諾管理 API のベース URL を取得することもできます。 次のリクエストを作成します。

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

実行に成功すると、次の応答が返されます。

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

api-lookup API の詳細について は、「 API Lookup 開発者ガイド」を参照してください。

承諾リクエストに新しい VIN を追加します

既存の承諾リクエストに VIN を追加するには、以下のリクエストを行います。

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"

承認されていないすべての VIN を JSON または csv ファイルから削除します

承認されていないすべての VIN を JSON または csv ファイルから削除するには、次のリクエストを行います。

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"

JSON または csv ファイルからすべての VIN を削除します

JSON または csv ファイルからすべての VIN を削除するには、次のリクエストを行います。

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"