@comms-id / apra-registered-financial-corporation-lookup
为通信键入的客户端。注册金融机构名单API (https://api.comms.id/apra-registered-financial-corporation-lookup/v1):在APRA公布的列表中查找ABN,或按名称开头(#715)进行搜索。
src/ 由合约(packages/apra-registered-financial-corporation-lookup-service/openapi/apra-registered-financial-corporation-lookup.v1.json) @comms-id/forge-transformers. 不要编辑它:更改合同并运行 pnpm --filter @comms-id/forge-transformers generate. src/local/profile.ts 是唯一的手写部分。
import { createApraRegisteredFinancialCorporationLookupClient } from "@comms-id/apra-registered-financial-corporation-lookup/server";
const client = createApraRegisteredFinancialCorporationLookupClient({
clientId: process.env.COMMS_ID_CLIENT_ID!,
privateJwk: JSON.parse(process.env.COMMS_ID_PRIVATE_JWK!),
});
const reply = await client.lookup({ abn: "45114248458" });
COMMS_ID_PRIVATE_JWK 是一架ML-DSA-87私人JWK (kty AKP, priv 和 pub). 服务器入口需要Node.js 24.7或更高版本,或者带有兼容性标志的Cloudflare Worker webcrypto_modern_algorithms.
操作
lookup:一个荷兰银行。outcome是match用事实,或者no-match,这只意味着ABN不在APRA的发布页面上。search:忽略名字的开头、大小写、重音和标点符号;默认有10条记录,最多50条truncated当有更多的时候。
每一个事实 source, observedAt, sourceDate (页面自己的“更新”日期)和 attribution,每个回复都附有页面注释,说明它不在《2001年金融部门(数据收集)法》第11(4)条的列表中。
先测试一下
createApraRegisteredFinancialCorporationLookupFixtureClient() 从 @comms-id/apra-registered-financial-corporation-lookup/fixtures 答案来自合同本身的例子,没有网络。要调用TEST服务,请通过 environment: "test".
这个领域是做什么的
- 一个名字: 在用户暂停后,它会建议公司(名称,ABN,类别或豁免)从APRA公布的注册金融公司名单。搜索已经返回了每条完整的记录,因此选择一条记录不需要第二次调用。APRA发布的没有ABN的行只能通过这种方式找到。
- 一个荷兰: 在浏览器中检查11位数字(允许空格)并立即查找。错误的长度或校验和被拒绝,并且不发送任何内容。
- 获豁免的法团被显示为“豁免注册”,而不是注册(FSCODA s7(2)(j))。
- “不在APRA公布的注册金融公司名单上”和“无法查询金融公司”是不同的消息。不在该页面上并不能证明公司未注册:APRA的法律名单是在宪报上公布的名单(第11(4)条)。