SSL API

SSL API

Con queste istruzioni ti spieghiamo come usare la nostra SSL API. L’API ti permette di recuperare i tuoi certificati SSL e di avviare i rinnovi in modo automatizzato.

Passo 1: attivare l’accesso API

Prima di poter usare la SSL API, vai su admin.firestorm.ch e accedi con il tuo FireStorm-ID. Attiva l’API sotto Konto => Kundenprofil => API Zugang.

Passo 2: copiare la chiave API

Dopo l’attivazione viene mostrata la tua chiave API personale. Copia questa chiave e usala per tutte le richieste API.

Passo 3: usare l’API

Con chiave API (consigliato)

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

Alternativa: Basic Auth

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

Endpoint API

Esempi

Elencare tutti i certificati

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

Risposta:

{
    "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"
        }
    ]
}

Filtrare per dominio

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

Dettagli del certificato con cronologia

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

Risposta:

{
    "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"
            }
        ]
    }
}

Rinnovare il certificato SSL

Un rinnovo è possibile se la data di scadenza cade entro i prossimi 90 giorni. Vengono creati automaticamente un nuovo ordine e una nuova fattura.

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

Risposta in caso di successo:

{
    "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
    }
}

Messaggi di errore

Note

• Reissue automatico: I tuoi certificati SSL vengono riemessi automaticamente prima della scadenza (Reissue). Devi solo avviare il rinnovo annuale (Renewal) tramite l’API.
• Periodo di rinnovo: Il rinnovo può essere avviato al più presto 90 giorni prima della data di scadenza.
• Fattura: Con il rinnovo viene creata automaticamente una fattura con il metodo di pagamento da te registrato.
• Rate Limiting: Dopo 25 tentativi di autenticazione falliti il tuo indirizzo IP viene bloccato per 6 ore.

Automazione con Cron

Esempio: controllo giornaliero se è dovuto un rinnovo (richiede 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

Per domande o assistenza contattaci tramite il nostro sistema di ticket.