機械翻訳について
  1. コンテンツ配信用のREST API
  2. タスク
  3. タクソノミ

公開されたタクソノミの読取り

get

/content/published/api/v1.1/taxonomies/{id}

公開済のタクソノミを返します。 タクソノミはIdによって一意に識別されます。
公開された各タクソノミには、次の情報が含まれます:
  1. 標準フィールド: これらはシステムによって作成されたフィールドです。
    • id: タクソノミのID。
    • name: タクソノミの名前。
    • description : タクソノミの説明。
    • shortName: タクソノミの短い名前。
    • customProperties: タクソノミに対して定義されたカスタム・プロパティ。
    • updatedDate : リクエストされたチャネル上のタクソノミの最終公開日。

    2. リクエスト・ヘッダー(オプション) :
    ヘッダー名ヘッダー値
    channelToken{有効なチャネル・トークン値}
    Acceptapplication/json

リクエスト

パス・パラメータ
問合せパラメータ
  • パブリッシュ・ターゲットのチャネル・トークン。 チャネル・トークンは、問合せパラメータまたはリクエスト・ヘッダーのいずれかとして提供する必要があります。
  • 展開パラメータは、タクソノミ・レスポンスにインラインで子リソース(参照アイテム)を取得するオプションを提供します。 フィールド名またはallのコンマ区切りリストを受け入れます。 このフィールドは現在無視されています。
トップに戻る

レスポンス

サポートされているメディア・タイプ

200レスポンス

操作の成功
本文()
ルート・スキーマ : タクソノミ
型: object
タクソノミ
Show Source
ネストされたスキーマ : date
型: object
date
Show Source
ネストされたスキーマ : customProperties
型: object
使用可能なその他のプロパティ
Show Source
タクソノミのカスタム・プロパティ。 これは、ユーザーによって定義される名前/値ペアで構成されます。

304レスポンス

変更されません。 リクエストは電子タグでリクエストを受け付けます。

400レスポンス

不正リクエスト。 サーバーは、不正な構文、無効なデータまたはメッセージ・フレーミングのために、クライアント側でリクエストを処理できません。

403レスポンス

禁止。 クライアントはこのリクエストを実行する権限がありません。

404レスポンス

リクエストされたリソースは見つかりませんでした。

500レスポンス

内部サーバー・エラー システムで予期しないエラーが発生しました。
トップに戻る

例

次の例は、公開されたタクソノミを読み取る方法を示しています。

curl -i -X GET -H "Accept:application/json" 'http://<hostname>/content/published/api/v1.1/taxonomies/{id}'
例

IDを持つ公開済タクソノミを読み取ります: 1143EFDC17EC47318DFA55D04F098433、channelToken: 986bc783d8c8452c813b7cf92dde0322。

/content/published/api/v1.1/taxonomies/1143EFDC17EC47318DFA55D04F098433?channelToken=986bc783d8c8452c813b7cf92dde0322

レスポンス本文

{
        "id": "1143EFDC17EC47318DFA55D04F098433",
        "name": "allChannels-taxonomyPublished-1-Test1261401333683001",
        "description": "Taxonomy Description - 1",
        "shortName": "ALL",
        "createdDate": {
          "value": "2020-07-08T13:17:09.162Z",
          "timezone": "UTC"
        },
        "updatedDate": {
          "value": "2020-07-08T13:17:58.289Z",
          "timezone": "UTC"
        },
        "links": [
          {
            "href": "https://<hostname>/content/published/api/v1.1/taxonomies/1143EFDC17EC47318DFA55D04F098433?channelToken=986bc783d8c8452c813b7cf92dde0322",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/published/api/v1.1/taxonomies/1143EFDC17EC47318DFA55D04F098433?channelToken=986bc783d8c8452c813b7cf92dde0322",
            "rel": "canonical",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/published/api/v1.1/metadata-catalog/taxonomies/1143EFDC17EC47318DFA55D04F098433?channelToken=986bc783d8c8452c813b7cf92dde0322",
            "rel": "describedby",
            "method": "GET",
            "mediaType": "application/schema+json"
          }
        ]
      }
トップに戻る