Kunden-IP abrufen
Gibt eine Kunden-IP inkl. DNSBL-Status zurück (falls vorhanden).
GET /api/customer-ips/:customerIpPublicId
Die Response enthält die Kunden-IP selbst und, falls vorhanden, ein dnsbl-Objekt. Ein vollständiger Kunden-Datensatz wird nicht eingebettet.
Beispiel-Response
{
"id": 1,
"publicId": "a19effb9-eb5f-459b-b5d6-2f615b574651",
"customerId": 2,
"customerName": "Zaskoku & Haupt GbR",
"label": "Kurbelix Adminserver",
"ipAddress": "77.75.254.185",
"ipFamily": "v4",
"status": "active",
"createdAt": "2026-02-03T15:06:46.469Z",
"updatedAt": "2026-02-03T15:06:46.469Z",
"dnsbl": {
"isListed": true,
"listedCount": 1,
"listings": [
{
"name": "all.s5h.net",
"reason": "Listed in all.s5h.net",
"listKey": "all.s5h.net",
"delistUrl": "http://s5h.net",
"resultCode": "127.0.0.2"
}
],
"lastError": null,
"lastCheckedAt": "2026-04-03T15:13:00.083Z",
"lastChangedAt": "2026-02-04T10:00:00.121Z",
"lastListedAt": "2026-04-03T15:13:00.083Z",
"lastCleanAt": null,
"lastNotifiedListedAt": "2026-04-02T20:55:04.969Z",
"lastNotifiedCleanAt": null
}
}Pfadparameter
customerIpPublicId(empfohlen): Public-ID der Kunden-IP als UUID- Legacy-Kompatibilität: numerische IDs werden weiterhin akzeptiert
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/customer-ips/11111111-1111-4111-8111-111111111111" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Häufige Fehler
400 Invalid IP identifierwenn:customerIpPublicIdweder UUID noch Legacy-ID ist401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keinen Zugriff auf den Kunden hast404 IP not foundwenn die IP nicht existiert