应用程式介面规格

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

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

规范:

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 用于返回配对结果