title: Kunden-IP (für Kunde) erstellen description: POST /api/customers/:customerPublicId/ips

Kunden-IP (für Kunde) erstellen

POST /api/customers/:customerPublicId/ips

Erstellt eine neue Kunden-IP für DNSBL-Überwachung.

Anfrage (Request Body)

{
  "ipAddress": "203.0.113.10",
  "label": "Mail Server",
  "ipFamily": "v4",
  "status": "active"
}

Hinweise:

• customerPublicId sollte die Public-ID des Kunden als UUID sein. Legacy-numerische Kunden-IDs bleiben aus Kompatibilitätsgründen weiter unterstützt.
• ipFamily ist optional (wird sonst aus der IP abgeleitet).
• Wenn ipFamily gesetzt ist, muss es zur IP-Version passen.
• Das Erstellen einer active IP kann wegen Quota-Limits abgelehnt werden.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X POST "$BASE_URL/api/customers/6bfec6f6-245a-47ce-843b-157d97d56f88/ips" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ipAddress":"203.0.113.10","label":"Mail Server","status":"active"}'

Häufige Fehler

• 400 Invalid Customer identifier wenn :customerPublicId fehlt/ungültig ist
• 400 Invalid IP address wenn ipAddress ungültig ist
• 400 IP family mismatch... wenn ipFamily nicht zur IP passt
• 401 Unauthorized wenn du nicht angemeldet bist
• 403 Forbidden für Readonly/Global-Supporter oder bei fehlendem Zugriff
• 403 Active IP limit reached... wenn Erstellung/Aktivierung dein Quota überschreitet
• 404 Customer not found wenn der Kunde nicht existiert
• 409 IP already exists for this customer wenn die IP bereits existiert

Antwort (Response)

Gibt das erstellte Kunden-IP-Objekt zurück. Siehe Fehlerliste für Fehlerantworten.