@comms-id /公司
为通信键入的客户端。身份证公司API (https://api.comms.id/asic-company-lookup/v1): ASIC公开注册的澳大利亚公司:按名称搜索,按ACN或ARBN查找。每条记录命名它的编号 asicNumber 这是一种 asicNumberType (ACN,或者 ARBN (适用于注册的外国公司或注册的澳大利亚机构)。公司v1及其 acn 油田退役(ADR-0050, #714);这个包的早期版本调用v1和get VERSION_RETIRED.
src/ 是根据公司合约(packages/asic-public-registers/openapi/asic-company-lookup.v1.json) @comms-id/forge-transformers. 不要编辑它:更改合同并运行 pnpm --filter @comms-id/forge-transformers generate.
import { createAsicCompanyLookupClient } from "@comms-id/asic-company-lookup/server";
const client = createAsicCompanyLookupClient({
clientId: process.env.COMMS_ID_CLIENT_ID!,
privateJwk: JSON.parse(process.env.COMMS_ID_PRIVATE_JWK!),
});
const reply = await client.lookup({"asicNumber": "001234564"});
操作
lookup:在公司快照中查找一个带有有效ASIC校验数字的九位数ASIC编号(ACN或ARBN)。不提供ABN查询。最多十行;没有独特性或完整的历史主张。search:按不区分大小写的名称前缀和可选的精确状态搜索公司快照。默认为8行,最多10行,无分页。快照错过并不能证明不在活动记录中。
每个操作都是读操作,可以安全地重复,并在可重试失败后重试。不匹配的应答是应答约定的结果之一:错误 outcomeOf(error) 的 no-match, source-unavailable 或者 failed;中断永远不是“不匹配”。
先测试一下
createAsicCompanyLookupFixtureClient() 从 @comms-id/asic-company-lookup/fixtures 从合同本身的例子中得到答案,没有网络,并说(fixture: true). 要调用TEST服务(合成回复,您的开发应用程序的键),请通过 environment: "test";上线只会改变环境和钥匙。
COMMS_ID_PRIVATE_JWK 是一架ML-DSA-87私人JWK (kty AKP, priv 和 pub). 服务器入口需要Node.js 24.7或更高版本,或者带有兼容性标志的Cloudflare Worker webcrypto_modern_algorithms.
条目: . (类型和错误,在浏览器中是安全的) ./server (每次呼叫都签名), ./browser (你的接力路线;从不签名), ./fixtures (本地装置,无网络), ./descriptor ( @comms-id/relay 可能向前)。
LICENSE 是消费者客户牌照。
领域
@comms-id/asic-company-lookup/controller 是公司名称、ACN或ARBN字段的无头控制器:输入、解码、建议、标识符检查、选择和错误,具有WAI-ARIA组合框属性和键处理程序。它没有框架,也没有DOM。 @comms-id/asic-company-lookup-react (一个钩子和一个组件) <comms-id-asic-company-lookup> (一个web元素)可以在上面运行,你自己的UI也可以。
import { createAsicCompanyLookupController } from "@comms-id/asic-company-lookup/controller";
const controller = createAsicCompanyLookupController({ client, onSelect: (record, timing) => console.log(record, timing.ms) });
controller.subscribe(() => render(controller.getState()));
controller.setQuery("…");
src/local/profile.ts 是唯一特定于产品的部分:它读取输入的文本,调用客户端并减少对ui显示的文本和记录的每个回复 onSelect 接收。其他一切都生成了。