Kunden-IPs (Kunde) auflisten
title: Kunden-IPs (Kunde) auflisten description: GET /api/customers/:customerPublicId/ips
Kunden-IPs (Kunde) auflisten
GET /api/customers/:customerPublicId/ips
Listet IPs eines Kunden inkl. DNSBL-Status auf.
Pfadparameter
customerPublicId(empfohlen): Public-ID des Kunden als UUID- Legacy-Kompatibilität: numerische Kunden-IDs werden weiterhin akzeptiert
Query-Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
envelope | string | keiner | items: Antwort als { items, total, page, perPage }. Ab 18.01.2027 Standard. |
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/customers/6bfec6f6-245a-47ce-843b-157d97d56f88/ips?envelope=items" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Häufige Fehler
400 Invalid Customer identifierwenn:customerPublicIdfehlt/ungültig ist401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keinen Zugriff auf den Kunden hast404 Customer not foundwenn der Kunde nicht existiert
Antwort (Response)
Gibt die IP-Objekte des Kunden zurück; jeder Eintrag kann ein dnsbl-Objekt enthalten.
Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage }. Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form (ein blankes Array derselben Einträge); sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.
Siehe Fehlerliste für Fehlerantworten.