Skip to content

Open platform

The open platform covers certificate apply, renew, revoke, record delete, domain validation, async operation status, and download. Full fields and examples live on the public Open platform API page. The console entry is Developer.

  1. Open the developer page

    Sign in and go to Developer.

  2. Copy the Access Key

    Send Authorization: Bearer YOUR_ACCESS_KEY.

  3. Reset the key if needed

    The old key stops working immediately. Update any scripts that still use it.

API Playground sends requests to production OpenAPI with the current account key.

  • Read-only endpoints can be sent directly.
  • Apply, renew, revoke, delete, and private-key download ask for confirmation first.
  • Requests hit production and may create real certificate jobs or return an unencrypted private key.

The public API is certificate lifecycle only. There is no monitor or automated-deployment API:

MethodPathPurpose
POST/v1/cert/check-domainPrepare DNS-01 CNAME records and return saved status
POST/v1/cert/applyapply / renew / revoke / delete
GET/v1/cert-operations/{operationId}Query an async operation
GET/v1/certList certificates
GET/v1/cert/{certKey}Certificate detail
GET/v1/cert/{certKey}/downloadDownload certificate and private key
  • DNS-01 (default): call check-domain first, then apply. Up to 100 names, wildcards allowed.
  • HTTP-01: set verificationType=http. Exactly one non-wildcard domain or IP. Do not call check-domain.

Apply, renew, and revoke are async. Store certKey, operationId, and requestKey, then poll until succeeded, failed, or canceled.