title: Kunden-Domain erstellen (Kunde) description: POST /api/customers/:customerPublicId/domainsAnkerlink kopieren

Kunden-Domain erstellen (Kunde)Ankerlink kopieren

POST /api/customers/:customerPublicId/domains

Erstellt eine Kunden-Domain für die Ablauf-Überwachung.

Request BodyAnkerlink kopieren

{
  "domainName": "deinkunde.com",
  "label": "Main Domain",
  "status": "active",
  "expiryWarningDays": 30,
  "expiryErrorDays": 7
}

Hinweise:

• customerPublicId sollte die Public-ID des Kunden als UUID sein. Legacy-numerische Kunden-IDs bleiben aus Kompatibilitätsgründen weiter unterstützt.
• domainName muss eine gültige Domain wie deinkunde.com sein (kein Protokoll, kein Pfad).
• Das Erstellen einer active Domain kann durch Quota-Limits blockiert 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/domains" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domainName":"deinkunde.com","label":"Main Domain","status":"active","expiryWarningDays":30,"expiryErrorDays":7}'

AntwortAnkerlink kopieren

200 mit dem Kunden-Domain-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 domainName -- dieselbe Domain mit einem anderen label, status oder anderen Schwellwerten ist eine andere Anfrage und legt sehr wohl einen zweiten Eintrag an, denn auf den Domainnamen selbst gibt es keine Eindeutigkeitsprüfung. Eine erkannte Wiederholung verbraucht kein Kontingent und stuft die Organisation nie eine Preisstufe hoch.

Häufige FehlerAnkerlink kopieren

• 400 Invalid Customer identifier wenn :customerPublicId fehlt/ungültig ist
• 400 Invalid domain name... wenn domainName ungültig ist
• 401 Unauthorized wenn du nicht angemeldet bist
• 403 Forbidden für Readonly/Global-Supporter-User, oder wenn du keinen Zugriff auf den Kunden hast
• 403 Active domain limit reached... wenn das Erstellen/Aktivieren dein Quota-Limit überschreiten würde
• 404 Customer not found wenn der Kunde nicht existiert