SSL API

SSL API

Mit dieser Anleitung erklären wir dir, wie du unsere SSL API verwenden kannst. Die API ermöglicht es dir, deine SSL-Zertifikate abzurufen und Verlängerungen automatisiert auszulösen.

Schritt 1: API-Zugang aktivieren

Bevor du die SSL-API verwenden kannst, gehe zu admin.firestorm.ch und melde dich mit deiner FireStorm-ID an. Aktiviere die API unter Konto => Kundenprofil => API Zugang.

Schritt 2: API-Key kopieren

Nach der Aktivierung wird dein persönlicher API-Key angezeigt. Kopiere diesen Key und verwende ihn für alle API-Anfragen.

Schritt 3: API verwenden

Mit API-Key (empfohlen)

curl -H "X-API-Key: DEIN_API_KEY" https://api.firestorm.ch/ssl/v1/certificates

Alternative: Basic Auth

curl -u "DEINE_EMAIL:DEIN_PASSWORT" https://api.firestorm.ch/ssl/v1/certificates

API Endpunkte

Beispiele

Alle Zertifikate auflisten

curl -H "X-API-Key: DEIN_API_KEY" https://api.firestorm.ch/ssl/v1/certificates

Antwort:

{
    "status": "OK",
    "count": 2,
    "certificates": [
        {
            "service_id": 12345,
            "domain": "example.ch",
            "product": "PositiveSSL",
            "service_status": "Active",
            "ssl_status": "Completed",
            "next_due_date": "2027-02-17",
            "valid_from": "2026-02-17",
            "valid_to": "2026-08-17",
            "days_until_expiry": 180,
            "common_name": "example.ch",
            "auto_reissue_count": 1,
            "last_auto_reissue": "2026-02-17 03:00:00"
        }
    ]
}

Nach Domain filtern

curl -H "X-API-Key: DEIN_API_KEY" "https://api.firestorm.ch/ssl/v1/certificates?domain=example.ch"

Zertifikat-Details mit Verlauf

curl -H "X-API-Key: DEIN_API_KEY" "https://api.firestorm.ch/ssl/v1/certificate?service_id=12345"

Antwort:

{
    "status": "OK",
    "certificate": {
        "service_id": 12345,
        "domain": "example.ch",
        "product": "PositiveSSL",
        "service_status": "Active",
        "ssl_status": "Completed",
        "next_due_date": "2027-02-17",
        "valid_from": "2026-02-17",
        "valid_to": "2026-08-17",
        "days_until_expiry": 180,
        "common_name": "example.ch",
        "auto_reissue_count": 1,
        "last_auto_reissue": "2026-02-17 03:00:00",
        "history": [
            {
                "valid_from": "2025-08-17",
                "valid_to": "2026-02-17",
                "common_name": "example.ch",
                "reissued_at": "2026-02-17 03:00:00"
            }
        ]
    }
}

SSL-Zertifikat verlängern

Eine Verlängerung ist möglich, wenn das Fälligkeitsdatum innerhalb der nächsten 90 Tage liegt. Es wird automatisch eine neue Bestellung und Rechnung erstellt.

curl -X POST -H "X-API-Key: DEIN_API_KEY" -H "Content-Type: application/json" -d '{"service_id": 12345}' https://api.firestorm.ch/ssl/v1/renew

Antwort bei Erfolg:

{
    "status": "OK",
    "message": "Renewal order created successfully.",
    "order_id": 67890,
    "invoice_id": 11111,
    "service": {
        "service_id": 12345,
        "domain": "example.ch",
        "product": "PositiveSSL",
        "next_due_date": "2027-02-17",
        "price_chf": 24.80
    }
}

Fehlermeldungen

Hinweise

• Automatisches Reissue: Deine SSL-Zertifikate werden automatisch vor Ablauf erneuert (Reissue). Du musst nur die jährliche Verlängerung (Renewal) über die API auslösen.
• Verlängerungszeitraum: Die Verlängerung kann frühestens 90 Tage vor dem Fälligkeitsdatum ausgelöst werden.
• Rechnung: Bei der Verlängerung wird automatisch eine Rechnung mit deiner hinterlegten Zahlungsmethode erstellt.
• Rate Limiting: Nach 25 fehlgeschlagenen Authentifizierungsversuchen wird deine IP-Adresse für 6 Stunden gesperrt.

Automatisierung mit Cron

Beispiel: Tägliche Prüfung ob eine Verlängerung fällig ist (benötigt jq):

#!/bin/bash
API_KEY="DEIN_API_KEY"
API_URL="https://api.firestorm.ch/ssl/v1"

# Alle Zertifikate abrufen
CERTS=$(curl -s -H "X-API-Key: $API_KEY" "$API_URL/certificates")

# Service IDs extrahieren und prüfen
echo "$CERTS" | jq -r ".certificates[] | .service_id" | while read SID; do
  DUE=$(echo "$CERTS" | jq -r ".certificates[] | select(.service_id == $SID) | .next_due_date")
  DAYS=$(( ($(date -d "$DUE" +%s) - $(date +%s)) / 86400 ))

  if [ "$DAYS" -le 30 ] && [ "$DAYS" -ge 0 ]; then
    echo "Service $SID: fällig in $DAYS Tagen - verlängere..."
    curl -s -X POST -H "X-API-Key: $API_KEY" 
      -H "Content-Type: application/json" 
      -d "{"service_id": $SID}" "$API_URL/renew"
  fi
done

Für Fragen oder Unterstützung kontaktiere uns unter support@firestorm.ch.