TLS-Zertifikatsbestellung stornieren

POST /tls/certificate/{certificate_id}/cancel

Bezeichner: CancelCertificate

Storniert eine ausstehende TLS-Zertifikatsbestellung. Für den vollständigen Widerruf einer bereits ausgestellten Bestellung ist /tls/certificate/{certificate_id}/order-cancel zu verwenden.

Pfad-Parameter

Name	Typ	Pflicht	Beschreibung
certificate_id	tlsCertificateId	ja	-

Request Body

tlsCertificateCancelRequest

Feld	Typ	Pflicht	Beschreibung
note	string	nein	Optionale Notiz an den Provider, die zum Stornierungsantrag gespeichert wird. Fehlt sie, sendet regfish eine Standardnotiz, da die CA für die Stornierung ausstehender Bestellungen eine Notiz verlangt.

Antworten

Status	Typ	Beschreibung
200	tlsCertificateResponse	Stornierung des TLS-Zertifikats angenommen
400	Error	Ungültige Anfrage
401	Error	Nicht autorisiert
404	Error	TLS-Zertifikat nicht gefunden
409	Error	Nur ausstehende TLS-Zertifikatsbestellungen können storniert 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>/cancel" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "note": "string"
  }'

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.