クレーム ID によるクレームの問い合わせ

GET /claim/v1/claims/{claimId} エンドポイントは、特定のクレームに関する情報を返します。その際の前提条件は、呼び出し元のリソースアクセスによってクレームの表示が呼び出し元に許可されていることです。

例えば、ID が cc:33 のクレームを Andy Applegate さんが所有しているとします。Betty Baker さんは Andy Applegate さんと同じグループに属しているので、Andy Applegate さんにアサインされたクレームを表示するリソースアクセス権限を持っています。Amy Baxter さんは、別のグループで働く事務担当ユーザーです。彼女にはクレーム cc:33 を表示するためのリソースアクセス権限がありません。

これらのユーザーがそれぞれ以下の呼び出しをトリガしたとします。

GET /claim/v1/claims/cc:33?fields=claimNumber

Andy Applegate さんに対する応答は以下のとおりです。

{
    "data": {
        "attributes": {
            "claimNumber": "235-53-425891"
        }
    }
}

Betty Baker さんに対する応答は以下のとおりです。

{
    "data": {
        "attributes": {
            "claimNumber": "235-53-425891"
        }
    }
}

Amy Baxter さんに対する応答は以下のとおりです。

{
    "status": 404,
    "errorCode": "gw.api.rest.exceptions.NotFoundException",
    "userMessage": "No resource was found at path /claim/v1/claims/cc:33"
}

リソースアクセスは、システム API の認証と権限フレームワークのコンポーネントです。 リソースアクセスの詳細については、『Cloud API 認証ガイド』を参照してください。