Domain-Missbrauchsbericht abrufen
Rufen Sie den aktuellen Missbrauchsstatus einer Domain ab (Beschwerden, Hold-Lebenszyklus, Szenarioklassifizierung). Gibt eine maschinenlesbare Zusammenfassung zurück, die für Reseller geeignet ist, die Domains im Auftrag ihrer Kunden überwachen.
Content-Type
application/json
Kategorie
abuse
action
get_abuse_report
Anforderungsparameter
| Parametername | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| domain | String (3-60) | Domainname | example.com |
Antwortparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| domain | String | Domainname |
| scenario | Object | Aktuelle Missbrauchsszenario-Klassifizierung (einer von sechs Domain-Zuständen) |
| scenario.status | String | Status-Phrase. Eine von: „Normal“, „Under Review“, „Pending ClientHold“, „ClientHold“, „Closed“, „ServerHold“ |
| scenario.impact | String | Auswirkungs-Phrase, die zum Status gehört, z. B. „At risk of restriction“, „Currently restricted“, „No restriction“ |
| scenario.action | String | Empfohlener nächster Schritt für den Domain-Inhaber |
| hold | Object | Zeitachse des Hold-Lebenszyklus |
| hold.state | String | Aktueller Hold-Status: keine / ausstehend / angewendet |
| hold.pending_since | Datetime | Zeitpunkt, zu dem die Domain in die Warteschlange für ausstehende Holds aufgenommen wurde (null, wenn kein Hold-Datensatz vorhanden ist) |
| hold.scheduled_at | Datetime | Geplante Ausführungszeit für clientHold. Wenn der Fall bis zu diesem Zeitpunkt nicht gelöst ist, wird clientHold automatisch angewendet. |
| hold.applied_at | Datetime | Zeitpunkt, zu dem clientHold tatsächlich angewendet wurde. Null, solange der Hold noch aussteht. |
| complaint | Object | Aggregierte Beschwerdestatistik für diese Domain |
| complaint.case_count | Integer | Anzahl unterschiedlicher Missbrauchsfälle zu dieser Domain (offen + geschlossen) |
| complaint.earliest_at | Datetime | Zeitstempel der frühesten für diese Domain eingegangenen Beschwerde |
| complaint.latest_at | Datetime | Zeitstempel der neuesten für diese Domain eingegangenen Beschwerde |
| complaint.categories | String[] | Unterschiedliche Missbrauchskategorien über alle zugehörigen Fälle, z. B. ["Phishing", "Malware"] |
| complaint.is_dns_abuse | Boolean | Zutreffend, wenn mindestens ein Fall als DNS-Missbrauch eingestuft ist |
| complaint.has_evidence | Boolean | Zutreffend, wenn bei mindestens einem Fall bestätigt wurde, dass ausreichende Beweise vorliegen |
| complaint.reported_urls | String[] | Aus Beschwerde-E-Mails für diese Domain extrahierte URLs (über alle zugehörigen Missbrauchsmeldungen dedupliziert). Leeres Array, wenn das Szenario Normal, ServerHold oder ein von der ICANN angeordneter ClientHold ist. |
| details_url_hint | String | Englischer Hinweis, der den Kunden zum Konsolenpfad führt, der die vollständigen Falldetails und die KI-generierte Beschwerdeübersicht anzeigt. |
Anfragebeispiel
{
curl https://api.nicenic.net/v2/?category=abuse&action=get_abuse_report&domain={domain}
-H "Authorization: username:api_secret"
-H "Content-Type: application/json"
}
Rückgabeergebnis
0 OK Erfolgreiche Antwort
{
"code": 0,
"msg" : "success",
"data" : {
"domain": "example.com",
"scenario": {
"status": "Pending ClientHold",
"impact": "At risk of restriction",
"action": "Submit supporting materials now"
},
"hold": {
"state": "pending",
"pending_since": "2026-04-20 10:30:00",
"scheduled_at": "2026-04-22 10:30:00",
"applied_at": null
},
"complaint": {
"case_count": 3,
"earliest_at": "2026-03-12 09:14:00",
"latest_at": "2026-04-22 18:02:00",
"categories": ["Phishing", "Malware"],
"is_dns_abuse": true,
"has_evidence": true,
"reported_urls": [
"http://example.com/promo/win-iphone",
"http://example.com/dl/installer.exe"
]
},
"details_url_hint": "For full case details and the AI-generated complaint summary, sign in to nicenic.com and go to My Account > My Products > Domain Name > Health Check."
}
}
400 Ungültige Anfrage
{
"code": 400,
"msg" : "Request parameter error",
}
