Ao vivo
Status do serviço
Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.
Categoria
Monitoramento
Pontos finais
5
Créditos
0-1
Autenticação
Autenticação necessária
Usado por pessoas em empresas incríveis
Sinais de confiança antes da integração
Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.
OpenAPI
Artefatos da API
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Chaves API
Acesso protegido
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
10,000
Cota gratuita
Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.
O que esta API ajuda você a lançar
Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.
Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.
Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.
Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.
Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.
Fluxo de integração
Um caminho simples da primeira requisição ao uso repetível em produção.
Autentique uma vez
Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.
Consulte com exemplos
Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.
Opere e monitore
Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.
Kit de desenvolvedor
Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.
Esquema OpenAPI
Gere clientes ou inspecione cada formato de requisição e resposta.
Coleção PostmanImporte requisições prontas para testes manuais e repasse ao time.
SDKs e CLIUse pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.
Integração MCPExponha inteligência de domínios para agentes de IA e assistentes internos.
Mapa de parâmetros e resposta
Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.
Parâmetro
domainnotify_emaildays
Resposta de Exemplo
watchlisttotalupdated_at
Códigos de Estado HTTP
200201400401402429
Pontos finais
GET
/v1/watchlist
POST
/v1/watchlist
domainnotify_email
DELETE
/v1/watchlist
domain
GET
/v1/watchlist/expiring
days
GET
/v1/watchlist/available
Sinais de confiança antes da integração
Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.
Status do serviço
Artefatos da API
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Chaves API
Acesso protegido
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
Cota gratuita
Cadastre-se Gratuitamente
Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.
Ativo
Pedido de Exemplo
Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.
Principais Recursos
Pontos finais
GET /v1/watchlist • POST /v1/watchlist • DELETE /v1/watchlist • GET /v1/watchlist/expiring • GET /v1/watchlist/available
Parâmetro
domain, notify_email, days
Códigos de Estado HTTP
200, 201, 400, 401, 402, 429
Créditos / Autenticação
0-1 / Autenticação necessária
Pedido de Exemplo
await fetch('https://domscan.net/v1/watchlist', {
credentials: 'include',
headers: {
Accept: 'application/json',
},
});await fetch('https://domscan.net/v1/watchlist', {
method: 'POST',
credentials: 'include',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
domain: 'startup.com',
notify_email: '[email protected]',
}),
});await fetch('https://domscan.net/v1/watchlist/expiring?days=30', {
credentials: 'include',
headers: {
Accept: 'application/json',
},
});Resposta de Exemplo
{
"watchlist": [
{
"domain": "startup.com",
"added_at": "2026-04-01T10:30:00Z",
"status": "registered",
"expiry_date": "2027-04-01T00:00:00Z",
"days_until_expiry": 352,
"last_checked": "2026-04-13T12:00:00Z",
"notify_email": "[email protected]",
"check_count": 9
}
],
"total": 1,
"updated_at": "2026-04-13T12:00:00Z"
}Perguntas frequentes
Quais endpoints estão incluídos?
Este guia cobre 5 endpoints públicos: GET /v1/watchlist, POST /v1/watchlist, DELETE /v1/watchlist, GET /v1/watchlist/expiring, GET /v1/watchlist/available.
Esta API exige autenticação?
Sim. Envie sua chave de API com o cabeçalho `X-API-Key` ou `Authorization: Bearer` ao chamar Lista de Observação de Domínios.
Quantos créditos ela usa?
As solicitações destes guias usam 0-1 créditos, dependendo do endpoint. Para endpoints em lote, os créditos usam a taxa padrão por item.
Onde posso ver os parâmetros completos e os endpoints relacionados?
Use a documentação completa de Lista de Observação de Domínios para revisar detalhes dos parâmetros, observações de autenticação e endpoints relacionados da mesma família de API.
Ferramentas e Recursos Relacionados
Códigos de Estado HTTP
Documentamos os códigos de estado HTTP que deves tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados em falta e falhas do serviço a montante.
OK
200
Pedido bem-sucedido
Criado
201
Recurso criado com sucesso.
Pedido inválido
400
Parâmetros inválidos
Não autorizado
401
Chave de API ou sessão em falta ou inválida.
Pagamento necessário
402
Não tens créditos suficientes para executar este pedido.
Demasiados pedidos
429
Limite de taxa excedido
Comece grátis com 10.000 créditos por mês. Use qualquer API pública e adicione créditos somente quando precisar.