BCI API Support Reference (version 1.0)


Master Data

States



URL path: REST Request SOAP Request Base
http://api.bciasia.com/rest/states.json http://api.bciasia.com/states.cfc?wsdl http://api.bciasia.com/states.cfc
Serializable: Yes
Properties:
Methods: getByPK, getByQuery
Localization and translation:
(BCI Asia API only)
Refer to the Localization and translation page for details.


getByPK
remote Struct getByPK ( required numeric state, string fields="", required string token )

Get Province Name and Abbreviation by ID

Methods of access are:

SOAP: http://api.bciasia.com/states.cfc?wsdl&method=getByPK&state={state}(&returnFormat=wddx / &returnFormat=json)

REST: http://api.bciasia.com/rest/states/{state}(.json / .xml)

Output: Structure

Parameters:
   state: numeric, required - ID of the specific province
   fields: string, optional - passing valid field names for the return structure. Valid fields : COUNTRYID,STATE,STATE_NAME
   token: string, required - allocated token for current login session

getByQuery
remote Array getByQuery ( string state, string countryid, string state_name, string fields="", required string token )

Get Province by Query (By Province Name, list of IDs, countryID)

Methods of access are:

SOAP: http://api.bciasia.com/states.cfc?wsdl&method=getByQuery(&returnFormat=wddx / &returnFormat=json)

REST: http://api.bciasia.com/rest/states(.json / .xml)

Output: Array

Parameters:
   state: numeric, optional - ID or comma-seperated list of IDs province(s)
   countryid: numeric, optional - CountryID or comma-seperated list of countryIDs
   state_name: string, optional - Name or comma-separated list of province names being searched
   fields: string, optional - passing valid field names for the return structure. Valid fields : COUNTRYID,STATE,STATE_NAME
   token: string, required - allocated token for current login session

Fields
Selectable fields for states information
STATELONG
STATE_NAMESTRING(100)
COUNTRYIDLONG
Fields in local languages
L_STATE_NAMESTRING(1000)