Oracle Fusionサービスでのナレッジ管理のREST API

言語に割り当てられたすべてのロケールを取得

get

/km/api/v1/languages/{id}/locales

このメソッドは、指定されたIDパラメータを持つLanguageオブジェクトに関連付けられたLocaleオブジェクトのリストを返します。

Localeオブジェクトは、そのオブジェクトが表す言語と国によって識別されます。たとえば、English United StatesとEnglish Great Britainは、英語のデフォルトである2つのロケールです。

このリソースは、返されるロケール・オブジェクトのリストをソートできるorderByリクエスト・パラメータをサポートしています。

orderByパラメータで使用する様々な値は、スキーマおよびリソースのカタログ情報で確認できます。スキーマおよびカタログ情報を取得するには、HTTPリクエストでmediaType値を'application/schema+json'としてGETメソッドを使用します。

リソースのスキーマおよびカタログを取得するURIの例を次に示します:

http://<IM_REST_API_HOST>/km/api/latest/metadata-catalog/locales

URIの例

このメソッドのURIの例を次に示します:

http://<IM_REST_API_HOST>/km/api/latest/languages/{id}/locales
このリクエストは、指定されたLanguageオブジェクトに関連付けられているFULLモードのLocaleオブジェクトのページ区切りリストを返します。デフォルトでは、LocaleオブジェクトはlocaleCodeパラメータ値で昇順にソートされます。
http://<IM_REST_API_HOST>/km/api/latest/languages/{id}/locales?mode=KEY
このリクエストは、指定されたLanguageオブジェクトに関連付けられているKEYモードのLocaleオブジェクトのページ区切りリストを返します。デフォルトでは、LocaleオブジェクトはlocaleCodeパラメータ値で昇順にソートされます。
http://<IM_REST_API_HOST>/km/api/latest/languages/{id}/locales?orderBy=localeDesc
このリクエストは、指定されたLanguageオブジェクトに関連付けられているFULLモードのLocaleオブジェクトのページ区切りリストを返します。ロケール・オブジェクトは、localeDescパラメータ値で昇順にソートされます。

リクエスト

パス・パラメータ

id: string

言語オブジェクトの一意の識別子

トップに戻る

レスポンス

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

application/json
application/xml

200 レスポンス

「OK」をクリックします。

ルート・スキーマ : ResultList LocaleKey

タイプ: object

タイトル: ResultList LocaleKey

ソースを表示

count(optional): integer

現在の範囲で返されたリソース・インスタンスの数。
hasMore(optional): boolean

サーバーで使用可能なリソースが現在のページで返されたサブセットよりも多い場合にtrueに設定されるブール値。
items(optional): array items
limit(optional): integer

サーバーが使用する実際のページング・サイズ。
links(optional): array links
offset(optional): integer

現在のページで使用される相殺値。
totalResults(optional): integer

現在の範囲内のインスタンスと、リクエストを満たすサーバー上のインスタンスの両方を含む、リソース・インスタンスの合計数。

{
    "title":"ResultList LocaleKey",
    "properties":{
        "hasMore":{
            "description":"Boolean value that is set to true if more resources are available on the server than the subset returned in current page.",
            "type":"boolean"
        },
        "limit":{
            "description":"Actual paging size used by the server.",
            "type":"integer"
        },
        "count":{
            "description":"Number of resource instances returned in the current range.",
            "type":"integer"
        },
        "totalResults":{
            "description":"Total count of the resource instances, including both the instances in the current range and the instances on the server that satisfy the request.",
            "type":"integer"
        },
        "items":{
            "items":{
                "$ref":"#/definitions/LocaleKey"
            },
            "type":"array"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        },
        "offset":{
            "description":"Offset value used in the current page. ",
            "type":"integer"
        }
    },
    "type":"object"
}

ネストされたスキーマ : アイテム

タイプ: array

ソースを表示

Array of: object LocaleKey

タイトル: LocaleKey

{
    "items":{
        "$ref":"#/definitions/LocaleKey"
    },
    "type":"array"
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

Array of: object instanceLink

JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

ネストされたスキーマ : LocaleKey

タイプ: object

タイトル: LocaleKey

ソースを表示

links(optional): array links
recordId(optional): string

ロケール・オブジェクトの一意の識別子。

{
    "title":"LocaleKey",
    "properties":{
        "recordId":{
            "description":"<p>The unique identifier of the Locale object.</p>",
            "type":"string"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        }
    }
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

Array of: object instanceLink

JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

ネストされたスキーマ : instanceLink

タイプ: object

JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

ソースを表示

href: string

URI [RFC3986]またはURIテンプレート[RFC6570]。値がURI Templateに設定されている場合、「templated」プロパティをtrueに設定する必要があります。
mediaType(optional): string

RFC 2046で定義された、リンク・ターゲットを説明するメディア・タイプ。
method(optional): string

リンクのターゲットをリクエストするためのHTTPメソッド。
profile(optional): string

ターゲット・リソースの参照解除時に予期されるリソースを記述する、JSONスキーマなどのリソースのメタデータへのリンク。
rel: string

リンクの詳細を取得するためにタイプ・プロパティに加えて使用できるリンク関係の名前。たとえば、hrefやprofileです。
templated(optional): boolean

hrefプロパティがURIまたはURIテンプレートであることを指定するブール・フラグ。プロパティがURIテンプレートの場合は、この値をtrueに設定します。デフォルトでは、この値はfalseです。

{
    "description":"Metadata describing link description objects that MAY appear in the JSON instance representation.",
    "properties":{
        "templated":{
            "description":"Boolean flag that specifies that \"href\" property is a URI or URI Template. If the property is a URI template, set this value to true. By default, this value is false.",
            "type":"boolean"
        },
        "method":{
            "description":"HTTP method for requesting the target of the link.",
            "type":"string"
        },
        "rel":{
            "description":"Name of the link relation that, in addition to the type property, can be used to retrieve link details. For example, href or profile.",
            "type":"string"
        },
        "href":{
            "description":"URI [RFC3986] or URI Template [RFC6570]. If the value is set to URI Template, then the \"templated\" property must be set to true.",
            "type":"string"
        },
        "mediaType":{
            "description":"Media type, as defined by RFC 2046, describing the link target.",
            "type":"string"
        },
        "profile":{
            "description":"Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource..",
            "type":"string"
        }
    },
    "required":[
        "href",
        "rel"
    ],
    "type":"object"
}

トップに戻る

例

次の例は、cURLを使用してRESTリソースに対する取得リクエストを発行することによって、指定した言語オブジェクトのロケール・オブジェクトのリストを検索する方法を示しています。

curl -X "GET" "http://IM_REST_API_HOST/km/api/latest/languages/{id}/locales"

リクエスト・ヘッダーの例

次に、リクエスト・ヘッダーの例を示します。

curl -X GET "https://<IM_REST_API_HOST>/km/api/latest/languages/{id}/locales" -u "<username:password>" -H "Accept: application/json" -H "Content-Type: application/json"

レスポンス本文の例

次の例は、JSON形式のレスポンス本文のコンテンツを示しています:

{
    "recordId": "ar_AE",
    "links": [
        {
            "rel": "canonical",
            "href": "https://<IM_REST_API_HOST>/km/api/v1/locales/ar_AE",
            "mediaType": "application/json, application/xml",
            "method": "GET"
        },
        {
            "rel": "collection",
            "href": "https://<IM_REST_API_HOST>/km/api/v1/locales",
            "mediaType": "application/json, application/xml",
            "method": "GET",
            "profile": "https://<IM_REST_API_HOST>/km/api/v1/metadata-catalog/locales"
        }
    ],
    "active": true,
    "dateAdded": "1970-01-01T23:11:11+0000",
    "dateFormat": "%d/%m/%Y",
    "dateFormatDisplay": "dd/mm/yyyy",
    "dateModified": "1970-01-01T23:11:11+0000",
    "encoding": "UTF-8",
    "groupDefault": true,
    "localeCode": "ar_AE",
    "localeDesc": "Arabic - United Arab Emirates",
    "localeValue": 14337,
    "timeFormat": "%I:%M %p",
    "timeFormatDisplay": "hh:mm",
    "language": {
        "recordId": "ar",
        "links": [
            {
                "rel": "canonical",
                "href": "https://<IM_REST_API_HOST>/km/api/v1/languages/ar",
                "mediaType": "application/json, application/xml",
                "method": "GET"
            }
        ]
    }
}

「トップに戻る」