TLS-Zertifikat widerrufen

POST /tls/certificate/{certificate_id}/revoke

Bezeichner: RevokeCertificate

Widerruft nur das aktuell ausgewählte TLS-Zertifikat; die Bestellung bleibt für eine spätere Neuausstellung bestehen.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
certificate_id	tlsCertificateId	ja	-

Request Body

tlsCertificateRevokeRequest

Feld	Typ	Pflicht	Beschreibung
comment	string	nein	Optionaler Kommentar an den Provider zum Widerrufsantrag.
revocation_reason	tlsCertificateRevocationReason	nein	Optionaler Widerrufsgrund, der an die CA weitergereicht wird. Ohne Angabe gilt unspecified.

Antworten

Status	Typ	Beschreibung
200	tlsCertificateResponse	Widerruf des TLS-Zertifikats angenommen
400	Error	Ungültige Anfrage oder ungültiger Widerrufsgrund
401	Error	Nicht autorisiert
404	Error	TLS-Zertifikat nicht gefunden
409	Error	Das TLS-Zertifikat kann in seinem aktuellen Zustand nicht widerrufen werden
500	Error	Unerwarteter Fehler
502	Error	Fehler beim vorgelagerten TLS-Provider

Antwortkörper

Feld	Typ	Pflicht	Beschreibung
success	boolean	ja	Erfolgskennzeichen
code	integer	nein	Antwort-/Fehlercode
response	tlsCertificateResponse	nein	-

Beispiel

curl -X POST "https://api.regfish.com/tls/certificate/<certificate_id>/revoke" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string",
    "revocation_reason": "cessationOfOperation"
  }'

Anfrage zusammenstellen

Werte eintragen - der Aufruf unten passt sich an. Es wird nichts abgeschickt: die API gibt Browser-Anfragen von dieser Domain aus derzeit nicht frei (CORS). Der API-Key wird nicht gespeichert.