香港金融管理局現提供以下應用程式介面:
使用香港金融管理局應用程式介面
規範:
https://api.hkma.gov.hk/public/api_uri?parameters…api_url 請參考各類別的應用程式介面規格。
至於可選的參數,請參考以下的「參數(可選)」
參數(可選)
參數名稱 | 描述 |
---|---|
pagesize | 最大顯示行數(預設值:100) 該應用程序介面將只顯示最多1000行數據。如果要檢索1000行以上的數據,請將其與”offset”結合使用(請參閱以下示例) 格式: pagesize=最大顯示行數的數量 例子: pagesize=10 |
offset | 返回結果中要偏移的行數。 格式: offset=偏移量 例子: offset=50 |
fields | 用於顯示選定的字段(默認:顯示每個API文檔中定義的所有字段) 格式: fields=field1,field2…. 例子: fields=end_of_month Notes: For API “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,filter | column: 用於輸入參數”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,to | choose: 用於輸入參數”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,sortorder | sortby: 用於輸入排序順序的字段名稱。 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 | 用於返回配對結果 |