SDK 与 API 事实边界
当前文档以 @acosmi/sdk-ts 为唯一已验证的一等 SDK;Go/Python/Java/OpenAPI 不再被写成同等可用。
当前可信来源
- TypeScript SDK:
@acosmi/sdk-ts@2.0.1,已从src/index.ts、src/compliance/client.ts、src/compliance/scopes.ts生成本仓库 inventory。 - Compliance scope:TS SDK 声明 15 个 scope。
- Backend OAuth registry:只读审计发现仍是 13 个 scope,少
compliance:contract_template:read/write。本仓库只记录偏差,不跨仓库修复。
Compliance scope 清单
compliance:evidence:read(ScopeComplianceEvidenceRead)compliance:evidence:write(ScopeComplianceEvidenceWrite)compliance:timestamp:issue(ScopeComplianceTimestampIssue)compliance:timestamp:verify(ScopeComplianceTimestampVerify)compliance:contract_signing:read(ScopeComplianceContractSigningRead)compliance:contract_signing:write(ScopeComplianceContractSigningWrite)compliance:seal:manage(ScopeComplianceSealManage)compliance:seal_approval:request(ScopeComplianceSealApprovalRequest)compliance:seal_approval:approve(ScopeComplianceSealApprovalApprove)compliance:seal_use:execute(ScopeComplianceSealUseExecute)compliance:reports:read(ScopeComplianceReportsRead)compliance:reports:write(ScopeComplianceReportsWrite)compliance:reports:publish(ScopeComplianceReportsPublish)compliance:contract_template:read(ScopeComplianceContractTemplateRead)compliance:contract_template:write(ScopeComplianceContractTemplateWrite)
ComplianceClient 方法
get, createEvidenceAsset, getEvidenceAsset, listEvidenceAssets, verifyEvidencePublic, issueTimestamp, issueTimestampForAsset, getTimestamp, listTimestamps, verifyTimestamp, listTsaProviders, getTsaStats, buildEvidencePackage, listEvidencePackages, createReport, getReport, listReports, publishReport, downloadReport, createSigningEnvelope, getSigningEnvelope, listSigningEnvelopes, signEnvelope, createH5SigningUrl, syncSigningEnvelopeStatus, listEnvelopeContracts, listEnvelopeProviderRequests, voidEnvelope, submitSealApproval, approveSealApproval, rejectSealApproval, cancelSealApproval, listPendingSealApprovals, getSealApproval, listSealApprovals, listSealUses, getProviderRequest, getCapabilities, listOperations, getOperation, createContractTemplate, updateContractTemplate, deleteContractTemplate, getContractTemplate, listContractTemplates, uploadContractTemplatePdf, publishContractTemplate, archiveContractTemplate, listContractTemplateVersions, classifyError, append, append, append, append
需要闸门闭合的方法
publishReport, signEnvelope, createH5SigningUrl, approveSealApproval
不再宣称
- 不宣称 Python / Java 一等 SDK 已发布。
- Go SDK 与 TypeScript 同步覆盖。
- 完整公开 OpenAPI 已上线。