TLS-Zertifikatsbestellung stornieren oder widerrufen

POST /tls/certificate/{certificate_id}/order-cancel

Storniert eine noch nicht ausgestellte Bestellung oder widerruft eine bereits ausgestellte Bestellung vollständig – Letzteres nur innerhalb der ersten 7 Tage nach der Bestellung. Ein vollständiger Widerruf macht alle Zertifikatsversionen dieser Bestellung ungültig und schließt ein erneutes Ausstellen aus.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
certificate_id	tlsCertificateId	ja	—

Request Body

tlsCertificateOrderCancelRequest

Feld	Typ	Pflicht	Beschreibung
comment	string	nein	Optionaler Kommentar an den Provider zur vollständigen Stornierung der Bestellung. Läuft die Anfrage auf die Stornierung einer ausstehenden Bestellung hinaus, sendet regfish eine Standardnotiz, sofern dieses Feld fehlt.
revocation_reason	tlsCertificateRevocationReason	nein	Optionaler Widerrufsgrund. Standardwert ist unspecified.

Antworten

Status	Typ	Beschreibung
200	tlsCertificateResponse	Stornierung der TLS-Zertifikatsbestellung angenommen
400	Error	Ungültige Anfrage oder ungültiger Widerrufsgrund
401	Error	Nicht autorisiert
404	Error	TLS-Zertifikat nicht gefunden
409	Error	Die TLS-Zertifikatsbestellung kann in ihrem aktuellen Zustand nicht storniert oder 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>/order-cancel" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "string",
    "revocation_reason": "unspecified"
  }'

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.