Obter relatório de abuso de domínio
Obtenha o status atual de abuso de um domínio (reclamações, ciclo de vida de retenção, classificação de cenário). Retorna um resumo legível por máquina, adequado para revendedores que monitoram domínios em nome de seus clientes.
Content-Type
application/json
category
abuse
action
get_abuse_report
Parâmetros da solicitação
| Nome do parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| domain | String (3-60) | Nome do domínio | example.com |
Parâmetros de resposta
| Nome do parâmetro | Tipo | Descrição |
|---|---|---|
| domain | String | Nome do domínio |
| scenario | Object | Classificação atual do cenário de abuso (um de seis estados de domínio) |
| scenario.status | String | Frase de status. Uma das opções: "Normal", "Under Review", "Pending ClientHold", "ClientHold", "Closed", "ServerHold" |
| scenario.impact | String | Frase de impacto associada ao status, ex.: "At risk of restriction", "Currently restricted", "No restriction" |
| scenario.action | String | Frase de próxima etapa recomendada para o proprietário do domínio |
| hold | Object | Cronograma do ciclo de vida do hold |
| hold.state | String | Estado atual de retenção: nenhum / pendente / aplicado |
| hold.pending_since | Datetime | Quando o domínio entrou na fila de retenção pendente (nulo quando não existe registro de retenção) |
| hold.scheduled_at | Datetime | Horário planejado para execução do clientHold. Se o caso não for resolvido até esse horário, o clientHold será aplicado automaticamente. |
| hold.applied_at | Datetime | Quando o clientHold foi realmente aplicado. Nulo enquanto a retenção ainda estiver pendente. |
| complaint | Object | Estatísticas agregadas de reclamações para este domínio |
| complaint.case_count | Integer | Número de casos de abuso distintos envolvendo este domínio (abertos + fechados) |
| complaint.earliest_at | Datetime | Data e hora da reclamação mais antiga recebida para este domínio |
| complaint.latest_at | Datetime | Data e hora da reclamação mais recente recebida para este domínio |
| complaint.categories | String[] | Categorias de abuso distintas em todos os casos relacionados, ex.: ["Phishing", "Malware"] |
| complaint.is_dns_abuse | Boolean | Verdadeiro quando pelo menos um caso é classificado como abuso de DNS |
| complaint.has_evidence | Boolean | Verdadeiro quando pelo menos um caso foi confirmado como tendo evidências suficientes |
| complaint.reported_urls | String[] | URLs extraídas de e-mails de reclamação para este domínio (deduplicadas em todos os registros de abuso relacionados). Matriz vazia quando o cenário é Normal, ServerHold ou ClientHold direcionado pela ICANN. |
| details_url_hint | String | Dica em inglês que orienta o cliente ao caminho no console que mostra os detalhes completos do caso e o resumo da reclamação gerado por IA |
Exemplo de solicitação
{
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 retorno
0 OK Resposta bem-sucedida
{
"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 Solicitação Inválida
{
"code": 400,
"msg" : "Request parameter error",
}
