API documentation
Obtén l\'informe d\'abús de domini
Obteniu l\'estat actual d\'abús d\'un domini (queixes, cicle de vida de la retenció, classificació de l\'escenari). Retorna un resum compatible amb màquina adequat per a revendedors que controlen dominis en nom dels seus clients.
Content-Type
application-json
categoria
abuse
acció
get_abuse_report
Paràmetres de la sol·licitud
| Nom del paràmetre | Tipus | Descripció | Exemple |
|---|---|---|---|
| domain | Text (3-60) | Nom de domini | example.com |
Paràmetres de resposta
| Nom del paràmetre | Tipus | Descripció |
|---|---|---|
| domain | Text | Nom de domini |
| scenario | Objecte | Classificació actual de l\'escenari d\'abús (una de les sis estats a nivell de domini) |
| scenario.status | Text | Frase d\'estat. Una de: "Normal", "En revisió", "En espera per part del client", "En espera del client", "Tancat", "En espera del servidor" |
| scenario.impact | Text | Frase d’impacte aparellada amb l’estat, per exemple «En risc de restricció», «Actualment restringit», «Sense restricció» |
| scenario.action | Text | Frase recomanada per al següent pas per al propietari del domini |
| hold | Objecte | Línia de temps del cicle de vida de la retenció |
| hold.state | Text | Estat actual de la retenció: cap / pendent / aplicat |
| hold.pending_since | Data i hora | Quan el domini va entrar a la cua d\'espera pendent (nul quan no existeix cap registre de retenció) |
| hold.scheduled_at | Data i hora | Temps d\'execució previst per a clientHold. Si el cas no es resol abans d\'aquest moment, clientHold s\'aplicarà automàticament. |
| hold.applied_at | Data i hora | Quan es va aplicar realment el clientHold. Null mentre la retenció encara està pendent. |
| complaint | Objecte | Estadístiques agregades de reclamacions per a aquest domini |
| complaint.case_count | Enter | Nombre de casos d\'abús diferents que involucren aquest domini (oberts + tancats) |
| complaint.earliest_at | Data i hora | Timestamp of the earliest complaint received fo this domini |
| complaint.latest_at | Data i hora | Marca temporal de la queixa més recent rebuda per a aquest domini |
| complaint.categories | Text[] | Categories d\'abús distintes en tots els casos relacionats, per exemple ["Phishing", "Malware"] |
| complaint.is_dns_abuse | Booleà | Cert quan almenys un cas està classificat com a Abús de DNS |
| complaint.has_evidence | Booleà | Cert quan almenys un cas s\'hagi confirmat que té proves suficients |
| complaint.reported_urls | Text[] | URLs extretes dels correus electrònics de denúncia per a aquest domini (sense duplicats entre tots els registres d’abús relacionats). Matriu buida quan l’escenari és Normal, ServerHold o ClientHold dirigit per ICANN. |
| details_url_hint | Text | Indicació en anglès que guia el client cap a la ruta de la consola que mostra els detalls complets del cas i el resum de la queixa generat per IA |
Exemple de sol·licitud
{
curl https://api.nicenic.net/v2/?category=abuse&action=get_abuse_report&domain={domain}
-H "Authorization: username:api_secret"
-H "Content-Type: application/json"
}
Resultat retornat
0 OK
Resposta correcta
{
"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 Sol·licitud incorrecta
{
"code": 400,
"msg" : "Request parameter error",
}
