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

Kunden-IP (für Kunde) erstellenAnkerlink kopieren

POST /api/customers/:customerPublicId/ips

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

Anfrage (Request Body)Ankerlink kopieren

{
  "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)Ankerlink kopieren

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 FehlerAnkerlink kopieren

• 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
• Es gibt auf dieser Route KEINE 409: eine Adresse, die bei diesem Kunden schon steht, kommt bei exakt demselben Body als erkannte Wiederholung zurück (siehe Antwort), bei abweichendem Body wird sie ein zweiter Eintrag

Antwort (Response)Ankerlink kopieren

200 mit dem Kunden-IP-Record, der jetzt zusätzlich das Feld deduplicated trägt.

Eine Wiederholung mit exakt demselben Body legt KEINEN zweiten, separat abgerechneten Monitor an: Es wird der bereits vorhandene Eintrag erneut zurückgegeben, und die Antwort trägt "deduplicated": true; eine erste Erstellung trägt "deduplicated": false. Beide Fälle antworten mit 200. Verglichen wird die vollständige Anfrage und nicht nur ipAddress -- dieselbe Adresse mit einem anderen label oder status ist eine andere Anfrage und legt sehr wohl einen zweiten Eintrag an, denn auf die Adresse selbst gibt es keine Eindeutigkeitsprüfung. Eine erkannte Wiederholung zählt nicht gegen die Grenze aktiver Adressen.

Siehe Fehlerliste für Fehlerantworten.