承諾リクエストのステータスを確認してください

個人を特定できる情報を含むデータにサブスクライブし、承諾リクエストを送信すると、承諾管理プロセスが開始されます。 データ主体は、データアクセスを許可または拒否するための承諾リクエストを確認します。 データ主体がリクエストを承認することで承諾を与えると、データが利用可能になります。

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

プラットフォーム 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

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

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 開発者ガイド」を参照してください。

承諾リクエストのステータスに加えて、 HERE Neutral Server API エンドポイントを使用して、保留中、承認済み、および取り消された承諾リクエストの合計数を確認することもできます。

• 特定の VIN 番号の承諾リクエストステータスを確認してください
• 共通の承諾リクエストのステータス ( 保留中、承認済み、および取り消された承諾リクエストの数 ) を確認します

特定の VIN 番号の承諾リクエストのステータスを確認します

承諾リクエストのステータス確認の例 :

https://consent.api.platform.here.com/consent-service/v1/consents/status?consentRequestId=consent_request_id&vin=JH1TB2H25CC000000

curl -X GET \
    -H "Accept: application/json" \
    "https://consent.api.platform.here.com/consent-service/v1/consents/status?consentRequestId=consent_request_id&vin=JH1TB2H25CC000000"

実行に成功すると、次のステータス情報が表示されます。

{
  "consentRequestId": "string",
  "vin": "JH1TB2H25CC000000",
  "state": "PENDING"
}

共通の承諾リクエストのステータスを確認します。保留中、承認済み、取り消された、拒否された、期限が切れた承諾リクエストの数です

一般的な承諾リクエストのステータスを取得する方法の例 :

https://consent.api.platform.here.com/consent-service/v1/consentRequests/consent_request_id/status
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET \
     -H "Authorization: Bearer <Authorization Token>" \
     -H "Cache-Control: no-cache" \
     -H "Accept: application/json" \
     "https://consent.api.platform.here.com/consent-service/v1/consentRequests/consent_request_id/status"

実行に成功すると、次のステータス情報が表示されます。

{
  "approved": 0,
  "pending": 0,
  "revoked": 0,
  "rejected": 0,
  "expired": 0
}