Oracle WebCenter Sites集約REST APIリファレンス

指定したサイトのアセットの検索

get

/resources/v1/search/sites/{siteName}/assets

リソース・エンドポイントは、1つのサイトのすべてのアセットのリストを返します。
これは、コレクション・リソースです。

次の表に、クライアント・リクエストをまとめます。

パス・パラメータ

名前	説明	形式
siteName	サイトの名前	文字列

問合せパラメータ

名前	説明	形式
countonly	ブール値を受け入れます。trueに設定すると、件数のみ表示され、結果は返されません。デフォルトはfalseです。	ブール
field:[fieldname]:[operation]	指定した演算を使用した[fieldname]のフィールドに対する問合せ条件を指定します。[Operation]はオプションで、equals、range、startswith、phrase、wildcard、similarまたはcontainsのいずれかを指定できます。デフォルトはcontainsです。range演算については、値の書式は{lower bound}:{upper bound}(たとえば、1:10)です。	文字列
fields	各検索結果の属性名のカンマ区切りのリストを受け入れます。デフォルトでは、各検索結果の名前と説明のみ返されます。	文字列
limit	返されるアイテムの合計数を指定します。	数値
links	リンク名のカンマ区切りのリストを受け入れます。デフォルトでは、このパラメータですべてのリンク(next、prev、first、last、schema、selfおよびcanonicalリソース)が返されます。	文字列
offset	結果を返す開始地点となる開始索引を指定します。	number
orderBy	結果のソート基準になるフィールドを指定します。使用方法: orderBy=[fieldname]:[asc/des]。注意: Luceneでは、トークン化されていない索引付けフィールドのみソートできます。	文字列
q	問合せ文字列を指定します。これは、構成時に指定された検索エンジン固有の問合せです。(デフォルトの検索エンジンはLuceneです。)	文字列
searchengine	検索に使用する検索エンジンを指定します。デフォルトの検索エンジンはLuceneです。	文字列
totalResults	ブール値を受け入れます。trueに設定すると、レスポンスに結果総数フィールドが表示されます。デフォルトはfalseです。	ブール

次の表に、サーバー・レスポンスをまとめます。

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

application/json
application/xml

200レスポンス

サイトのすべてのアセットのリスト。

次の例に、cURLを使用してRESTリソースに対するGETリクエストを送信し、WebCenter Sitesでavisportsサンプル・サイトの任意のアセット・タイプの任意のアセット名を2つ取得する方法を示します。REST URLで、nextリンクのみを返すことも指定します。

問合せパラメータの詳細:

"limit=2": 2つの結果のみ必要です。'offset'が指定されていないため、デフォルトは0です。
"fields=name": アセットの名前のみ必要です。
"links=next": nextリンクのみ表示されます。

curl -i -H "Accept: application/json" -X GET "http://<host>:<port>/<context>/REST/resources/v1/search/sites/avisports/assets?fields=name&limit=2&links=next"

レスポンス・ヘッダーの例

次の例に、レスポンス・ヘッダーを示します。

<Response header>Cache-Control: max-age=0 
ETag: "d605d7410eedbd743986bf087f03066ccfa977987b9ccfc5cced1f3564762b92" 
Content-Type: application/json;charset=utf-8

レスポンス本文の例

次の例に、JSON形式のレスポンス本文のコンテンツを示します。

{
  "offset": 0,
  "limit": 100,
  "count": 2,
  "hasMore": true,
  "links": [
    {
      "href": "http://<host>:<port>/<context>/REST/resources/v1/search/sites/avisports/assets?limit=2&links=next&fields=name&offset=2",
      "rel": "next",
      "templated": false,
      "mediaType": "",
      "method": "",
      "profile": ""
    }
  ],
  "items": [
    {
      "name": "Veteran Skier Says Goodbye",
      "link": {
        "href": "http://<host>:<port>/<context>/REST/resources/v1/aggregates/avisports/AVIArticle/1328196047241",
        "rel": "assetReference",
        "templated": false,
        "mediaType": "",
        "method": "GET",
        "profile": ""
      },
      "id": "AVIArticle:1328196047241"
    },
    {
      "name": "Rookie Skier Makes Her Mark",
      "link": {
        "href": "http://<host>:<port>/<context>/REST/resources/v1/aggregates/avisports/AVIArticle/1328196047309",
        "rel": "assetReference",
        "templated": false,
        "mediaType": "",
        "method": "GET",
        "profile": ""
      },
      "id": "AVIArticle:1328196047309"
    }
  ]
}