Sign inGet Started
Rozpocznij
Przewodniki
Referencja API
SDK
CLI
Baza wiedzy
Changelog

Get the webhook client certificate

GET
/v1/workspace/webhook-client-certificate
curl -X GET "https://us1.platform.bird.com/v1/workspace/webhook-client-certificate" \
  -H "Authorization: Bearer $TOKEN"
Odpowiedź200
{
  "state": "disabled",
  "crl_check": "disabled",
  "certificate": {
    "subject": "CN=bird-webhooks,O=Example Inc.",
    "issuer": "CN=Example Client CA,O=Example Inc.",
    "serial_number": "4f2a91c0d3",
    "fingerprint_sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
  },
  "signing_request": {
    "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIB...\n-----END CERTIFICATE REQUEST-----\n"
  }
}

Returns the client certificate that we present on webhook deliveries of your workspace, its state and any waiting signing request. Realtime delivers realtime.* events without the certificate. Connector endpoints and MCP Events subscriptions never present it.

Treść odpowiedzi

state
string
wymagane

Whether client certificates are off (disabled), checked while the previous behavior stays available (evaluating), or required (enforced).

Possible values: disabled, evaluating, enforced

crl_check
string
wymagane

How a certificate chain is checked against the certificate revocation list (CRL) that each certificate names. With full_chain, the leaf certificate and each intermediate certificate below the trusted root are checked. A certificate that names no CRL is not checked.

Possible values: disabled, full_chain

certificate
nullable object
wymagane

The certificate in use. null until you upload one.

Pokaż atrybuty podrzędne
certificate.subject
string
wymagane

The distinguished name of the certificate.

certificate.issuer
string
wymagane

The distinguished name of the certificate authority that signed it.

certificate.serial_number
string
wymagane

The serial number, in lowercase hexadecimal.

certificate.fingerprint_sha256
string
wymagane

The SHA-256 fingerprint of the certificate, in lowercase hexadecimal.

certificate.not_before
string
wymagane

Start of the validity period.

certificate.not_after
string
wymagane

End of the validity period.

signing_request
nullable object
wymagane

The signing request that waits for a signed certificate. null when none waits.

Pokaż atrybuty podrzędne
updated_at
nullable string
wymagane

When the certificate or its state last changed. null until the first change.

Powiązane zasoby

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.

Uzyskaj brief wdrożeniowy