开放接口

`/v1/certificate-publications`

2 个接口

方法	路径	摘要	认证
GET	`/v1/certificate-publications`	List current certificate publication statuses	登录会话
GET	`/v1/certificate-publications/{site_id}/revisions/{revision}`	Get one binding revision and its complete state history	登录会话

契约文件：api/control-certificate-publications.openapi.yaml

接口详情

List current certificate publication statuses

operationId

listCertificatePublicationStatuses

认证

所需权限

全部需要：certificates.read

listCertificatePublicationStatuses 参数
名称	位置	类型	必填	说明
`target_scope_id`	query	`string(uuid)`	否	Required for platform actors; tenant actors may target only their own scope.
`state`	query	`string: pending / leased / retry_wait / succeeded / permanent_failed`	否	—
`operation`	query	`string: publish / unpublish`	否	—
`site_id`	query	`string(uuid)`	否	—
`limit`	query	`integer`	否	—
`cursor`	query	`string`	否	Opaque signed snapshot cursor bound to actor, tenant and filters.
`X-Request-ID`	header	`string`	否	—

listCertificatePublicationStatuses 响应
状态码	说明
`200`	Current publication state page from one stable snapshot. 字段：`items: array<PublicationStatus>` `snapshot_at: string(date-time)` `next_cursor?: string`
`400`	Invalid query, scope target, body or cursor.
`401`	Bearer session missing, malformed or invalid.
`403`	Scope or certificates.read permission denied.
`405`	Only GET is supported.
`500`	Sanitized publication status storage or cursor encoding failure.

Get one binding revision and its complete state history

operationId

getCertificatePublicationStatus

认证

所需权限

全部需要：certificates.read

getCertificatePublicationStatus 参数
名称	位置	类型	必填	说明
`site_id`	path	`string(uuid)`	是	—
`revision`	path	`integer(int64)`	是	—
`target_scope_id`	query	`string(uuid)`	否	Required for platform actors; tenant actors may target only their own scope.
`X-Request-ID`	header	`string`	否	—

getCertificatePublicationStatus 响应
状态码	说明
`200`	Current state and complete ordered history for one binding revision. 字段：`current: PublicationStatus` `history: array<PublicationStatusEvent>`
`400`	Invalid query, scope target, body or cursor.
`401`	Bearer session missing, malformed or invalid.
`403`	Scope or certificates.read permission denied.
`404`	Route or exact site binding revision is absent.
`405`	Only GET is supported.
`500`	Sanitized publication status storage or cursor encoding failure.