Get Locales for Filtered Content - Fluid Topics - 3.6

Use Fluid Topics Web API

Product
Fluid Topics
FT_Version
3.6
Category
Technical Notes
language
English

This web service is used to get the usable content locales for specific Fluid Topics sources only, with the count of Knowledge Hub items for each locale.

A list of filters is provided in the body to filter the Knowledge Hub items, as for the public search web services.

Method

Endpoint

POST

/api/khub/locales/search

Return codes

Return Code

Description

200 OK

Returns 0 or more results.

400 BAD REQUEST

Invalid JSON input.

500 INTERNAL SERVER ERROR

The Query Manager failed to respond.

Input Example

The input JSON expects the following parameters:

Parameter

Description

key

Expects the facet name.

values

Expects the facet values.

If called with an empty JSON {} or an empty list of filters, the results are the same as they are when using the GET /api/khub/locales webservice.

The following lines display an example of JSON input:

{
"filters": [
{
"key": "product",
"values": ["poneySoft"]
},
{
"key": "ft:sourceId",
"values": ["source-A", "source-B"]
}
]
}

Output Example

{
"contentLocales": [
{
"lang": "fr",
"label": "Français",
"count": 42
},
{
"lang": "zh-CN",
"label": "中文 (大陆)",
"count": 42
}
]
}

With the following parameters:

Parameter

Description

lang

The content language ISO code.

label

The language as displayed on the portal.

count

Number of Knowledge Hub items corresponding to the given language.