Obtener informe de abuso del dominio
Obtenga el estado actual de abuso de un dominio (quejas, ciclo de vida de retención, clasificación de escenarios). Devuelve un resumen legible por máquina adecuado para que los revendedores supervisen dominios en nombre de sus clientes.
Content-Type
application/json
categoría
abuse
action
get_abuse_report
Parámetros de solicitud
| Nombre del parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| domain | String (3-60) | Nombre de dominio | example.com |
Parámetros de respuesta
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
| domain | String | Nombre de dominio |
| scenario | Object | Clasificación actual del escenario de abuso (uno de los seis estados a nivel de dominio) |
| scenario.status | String | Frase de estado. Una de: "Normal", "En revisión", "ClientHold pendiente", "ClientHold", "Cerrado", "ServerHold" |
| scenario.impact | String | Frase de impacto asociada al estado, p. ej., "En riesgo de restricción", "Actualmente restringido", "Sin restricción" |
| scenario.action | String | Frase de siguiente paso recomendado para el titular del dominio |
| hold | Object | Cronología del ciclo de vida del bloqueo |
| hold.state | String | Estado de retención actual: ninguno / pendiente / aplicado |
| hold.pending_since | Datetime | Cuándo el dominio entró en la cola de retención pendiente (nulo si no existe registro de retención) |
| hold.scheduled_at | Datetime | Tiempo de ejecución planificado de clientHold. Si el caso no se resuelve para este momento, clientHold se aplicará automáticamente. |
| hold.applied_at | Datetime | Cuándo se aplicó realmente clientHold. Nulo mientras la retención sigue pendiente. |
| complaint | Object | Estadísticas de quejas agregadas para este dominio |
| complaint.case_count | Integer | Número de casos de abuso distintos que involucran este dominio (abiertos + cerrados) |
| complaint.earliest_at | Datetime | Marca de tiempo de la queja más antigua recibida para este dominio |
| complaint.latest_at | Datetime | Marca de tiempo de la queja más reciente recibida para este dominio |
| complaint.categories | String[] | Categorías de abuso distintas en todos los casos relacionados, p. ej., ["Phishing", "Malware"] |
| complaint.is_dns_abuse | Boolean | Verdadero cuando al menos un caso se clasifica como abuso DNS |
| complaint.has_evidence | Boolean | Verdadero cuando se ha confirmado que al menos un caso tiene evidencia suficiente |
| complaint.reported_urls | String[] | URLs extraídas de los correos de queja para este dominio (deduplicadas en todos los registros de abuso relacionados). Matriz vacía cuando el escenario es Normal, ServerHold o ClientHold dirigido por ICANN. |
| details_url_hint | String | Indicación que guía al cliente a la ruta de la consola que muestra los detalles completos del caso y el resumen de queja generado por IA. |
Ejemplo de solicitud
{
curl https://api.nicenic.net/v2/?category=abuse&action=get_abuse_report&domain={domain}
-H "Authorization: username:api_secret"
-H "Content-Type: application/json"
}
Resultado de la respuesta
0 OK Respuesta exitosa
{
"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 Solicitud incorrecta
{
"code": 400,
"msg" : "Request parameter error",
}
