BCI API Support Reference (version 1.0)


Localization and Translation

Search localized information (Applicable for BCI Asia API only)

Some key information is available in both English and a local language. The local language is determined by the country for which the data is applicable, for example a project in Thailand would have project data in english and thai(but no other local language). Also if a company is located in Vietnam, the company information is available in english and vietnamese (but no other local language).

By default, the API searches English content only when processing query requests. If you wish to search across the local language fields, please pass the parameter search_languages in the API request. For example if you wish to search projects using a project name across both english and thai languages, you would pass the parameter search_languages=en,th along with the actual project name parameter project_name=School(for example)

Parameter search_languages supports any one or combination of the following values, separated by a comma:


Example 1: Search project name for "school" across english and local languages:
URL request:
https://api.bciasia.com/projects.cfc?token={token}&method=getByQuery&project_name=school&search_languages=en,local


Example 2: Search project name for "พาร์ทเมนท์" across english and thai languages:
URL request:
https://api.bciasia.com/projects.cfc?token={token}&method=getByQuery&project_name=พาร์ทเมนท์&search_languages=en,local


Request Format : Search across languages:
URL request:
https://api.bciasia.com/{API endpoint}?token={token}&method={method name}&{search parameters}&search_languages={comma seperated string of language codes}

Extracting Master Data in local languages

This refers to master data which are normally returned with a normal API response, for example country name is usually returned with project data. Be default this only returns english and not local in any local language.

Other examples of such master data could be project categories, project stages, province names, etc

Master table data can be requested to be returned in upto four local languages: Chinese, Thai, Indonesian and Vietnamese.

Use parameter master_data_languages to return master table data in other languages in addition to english.

Valid values for parameter master_data_languages - Any one or combination of the following values, separated by comma:

Example 1:
The request http://api.bciasia.com/projects.cfc?wsdl&method=getByQuery&project_name=school&fields=projectid,country_name&master_data_languages=zh,th returns country names in both Chinese and Thai.

Example 2:
The request http://api.bciasia.com/projects.cfc?wsdl&method=getByQuery&project_name=school&fields=projectid,projectstage&master_data_languages=id,th returns country names in both Chinese and Thai.

Request Format:
http://api.bciasia.com/projects.cfc?wsdl&method=getByQuery&{search_parameters}&fields={field selection}&master_data_languages={comma seperated list of languages}