TLS-Zertifikatsbestellung stornieren

POST /tls/certificate/{certificate_id}/cancel

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.