應用程式介面規格

香港金融管理局現提供以下應用程式介面:

使用香港金融管理局應用程式介面

規範:

api_url?parameters…

api_url 請參考各類別的應用程式介面規格。

至於可選的參數,請參考以下的「參數(可選)」

參數(可選)

參數名稱描述
pagesize最大顯示行數(預設值:100)
該應用程序介面將只顯示最多100行數據。如果要檢索100行以上的數據,請將其與“offset”結合使用(請參閱以下示例)
格式: pagesize=最大顯示行數的數量
例子: pagesize=10
offset返回結果中要偏移的行數。
格式: offset=偏移量
例子: offset=50
fields用於顯示選定的字段(默認:顯示每個API文檔中定義的所有字段)
格式: fields=field1,field2….
例子: fields=end_of_month

Notes: For Register of Securities Staff of Ais (eRegister), only applied to fields [name_en, name_tc, current_registration, business_address, conditions, registration_history, public_disciplinary_action]
column,filtercolumn: 用於輸入參數“filter”的字段名稱
filter: 用於輸入數字或日期中定義字段的值

如數據類型為文字,請使用使用引號("")和逗號(,)來分隔值

數字和日期格式: column=field name&filter=field value1,field value2
文字格式: column=field name&filter="field value1","field value2"
數字和日期例子: column=end_of_month&filter=1997-01,1997-02
文字例子: column=address&filter="15/F, central...","16/F, wai chai...."

Notes: Not applied to API Register of Securities Staff of Ais (eRegister)
choose,from,tochoose: 用於輸入參數“from”和“to”的字段名稱(結果將大於或等於較低值,小於或等於較高值)
from: 用於輸入數字或日期中定義哪個字段的較低值
to: 用於輸入數字或日期中定義哪個字段的較高值
格式: column=field name&from=lower value&to=higher value
例子: choose=end_of_month&from=1997-01&to=1997-12

Notes: Not applied to API Register of Securities Staff of Ais (eRegister)
sortby,sortordersortby: 用於輸入排序順序的字段名稱。
sortorder: 用於輸入排序順序
格式: sortby=field name&sortorder=asc|desc
例子: sortby=end_of_month&sortorder=desc

Notes: Not applied to API Register of Securities Staff of Ais (eRegister)

回應值(JSON)

回應字段描述
success識別JSON是否返回成功
err_code返回錯誤代碼
err_msg返回簡要說明
datasize返回記錄數目
records用於返回配對結果