跳到主内容
开发者

一个 SDK,一条稳定 API。

前端、插件与 SaaS 都通过 @acosmi/sdk-ts 调用稳定 API,不感知证书与底层 provider。本官网自身的公开验真即由该 SDK 驱动。

TypeScript SDK

@acosmi/sdk-ts

官方 TypeScript SDK,覆盖 OAuth 登录、token 管理、compliance 子客户端与匿名公开验真。

npm install @acosmi/sdk-ts
匿名公开验真
import { Client } from '@acosmi/sdk-ts';
// 同源调用:浏览器只与官网自身 origin 通信
const client = new Client({
serverURL: window.location.origin,
complianceBaseURL: window.location.origin + '/admin-api',
});
// 匿名公开验真 —— 无需登录、无需 scope
const result = await client.compliance
.verifyEvidencePublic({ evidenceNo: 'EV-2026-0001' });
console.log(result.contentHash, result.verifiedAt);
权限 Scope

Compliance 细粒度权限。

合规能力按细粒度 scope 授权。公开验真无需任何 scope;其余能力按需申请。

compliance:evidence:read读取证据资产
compliance:evidence:write登记与更新证据资产
compliance:time_seal:issue申请签发时间章
compliance:time_seal:verify校验时间章令牌
compliance:contract_signing:read读取合同签署信息
compliance:contract_signing:write创建与推进合同签署
compliance:seal:manage管理印章资产
compliance:seal_approval:request发起用印审批
compliance:seal_approval:approve审批用印申请
compliance:seal_use:execute执行单次用印
compliance:reports:read读取出证报告
compliance:reports:write创建与更新出证报告
compliance:reports:publish发布出证报告
登录

OAuth 授权登录。

登录通过统一账号中心的 OAuth 授权完成。需要写能力时,按上述细粒度 scope 申请授权。

登录