Безопасность и доверие · Продукт DomScan

API Обнаружение опечаток

Обнаруживайте угрозы опечаток и похожие домены, которые могут быть использованы для фишинга или нарушения бренда.

Что вы получите

Обнаруживайте угрозы опечаток и похожие домены, которые могут быть использованы для фишинга или нарушения бренда.

СинхронныйRESTMCPSDKИнтерактивный инструмент

Выберите этот продукт, если

Для кого этот продукт

Используйте ограниченные пассивные проверки для триажа и исследования, а не вместо авторизованных тестов или анализа человека.

Выберите этот продукт, если

Выбирайте для генерации вероятных похожих вариантов и проверки их статуса без трактовки неизвестного как безопасного.

Что вы получите

Обнаруживайте угрозы опечаток и похожие домены, которые могут быть использованы для фишинга или нарушения бренда.

Конечные точки

Перед интеграцией посмотрите, что принимает и возвращает каждый эндпоинт, а также его режимы и ограничения.

Кредиты и аутентификация

2-18 Требуется аутентификация. Точную стоимость, включая цены за отдельные элементы, смотрите в справочнике API.

Пример операции

Используйте документированные операции для сбора, оценки, обогащения, проверки, сравнения, защиты или мониторинга открытых данных.

GET /v1/typos Кредиты: 2-3

Параметры запроса

Параметр Тип обязателен
domain string обязателен
check_registered boolean
По умолчанию false
опционально
limit integer
По умолчанию 100
опционально
include_tld_swap boolean
По умолчанию true
опционально

Поля ответа

Поле Тип
domain string
name string
tld string
permutations_generated integer
permutations_checked integer
registered_typos[] object[]
registered_typos[] object
registered_typos[].classification object
registered_typos[].classification.status string
registered_typos[].classification.reason string
registered_typos[].classification.evidence object
registered_typos[].classification.evidence.source string
registered_typos[].classification.evidence.method string
registered_typos[].classification.evidence.observed_at string
registered_typos[].classification.evidence.detail string
registered_typos[].classification.checked_at string
registered_typos[].domain string
registered_typos[].name string
registered_typos[].tld string
registered_typos[].type string
registered_typos[].risk string
registered_typos[].description string
registered_typos[].registered boolean
registered_typos[].checked_at string
available_typos integer
unknown_typos integer
risk_summary object
risk_summary.critical integer
risk_summary.high integer
risk_summary.medium integer
risk_summary.low integer
threat_level string
family_summary object
family_summary.generated_by_type object
family_summary.generated_by_risk object
family_summary.registered_by_type object
family_summary.registered_by_risk object
family_summary.top_generated_family string | null
family_summary.top_registered_family string | null
family_summary.critical_or_high_generated_count integer
family_summary.critical_or_high_registered_count integer
family_summary.coverage_ratio number
family_summary.checked_count integer
family_summary.available_count integer
family_summary.unknown_count integer
family_summary.omitted_count integer
family_summary.include_tld_swap boolean
family_summary.requested_limit integer
checked_at string
check_duration_ms integer
meta object
meta.served_by string
meta.cached boolean
meta.query_time_ms integer
meta.registration_check_requested boolean
meta.registration_check_limit integer

Пример запроса

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/typos?domain=google.com&check_registered=false&limit=25&include_tld_swap=true"
const response = await fetch("https://domscan.net/v1/typos?domain=google.com&check_registered=false&limit=25&include_tld_swap=true", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/typos?domain=google.com&check_registered=false&limit=25&include_tld_swap=true",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/typos?domain=google.com&check_registered=false&limit=25&include_tld_swap=true", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/typos?domain=google.com&check_registered=false&limit=25&include_tld_swap=true")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Пример ответа

{
  "domain": "google.com",
  "name": "google",
  "tld": "com",
  "permutations_generated": 100,
  "permutations_checked": 95,
  "registered_typos": [
    {
      "domain": "gooogle.com",
      "name": "gooogle",
      "tld": "com",
      "type": "repetition",
      "risk": "high",
      "description": "Repeated character",
      "registered": true
    },
    {
      "domain": "gogle.com",
      "name": "gogle",
      "tld": "com",
      "type": "omission",
      "risk": "critical",
      "description": "Missing character",
      "registered": true
    }
  ],
  "available_typos": 50,
  "risk_summary": {
    "critical": 2,
    "high": 5,
    "medium": 10,
    "low": 28
  },
  "threat_level": "high",
  "checked_at": "2024-01-15T12:00:00Z"
}

Коды состояния HTTP

  • 200 OK
  • 400 Неверный запрос
  • 401 Не авторизован
  • 402 Требуется оплата
  • 429 Слишком много запросов

Часто задаваемые вопросы

Где найти справочник запросов и ответов для Обнаружение опечаток?

В справочнике API для Обнаружение опечаток описаны параметры, поля ответа, примеры, коды состояния и поддерживаемые режимы выполнения.

Как интерпретировать неизвестные или неполные результаты Обнаружение опечаток?

Статус «неизвестно» или «частично» означает, что мы не смогли полностью подтвердить результат. Учитывайте статус, достоверность, актуальность и ограничения, когда действуете на основе результата.

Как рассчитывается цена Обнаружение опечаток?

Цена зависит от проверки и выбранного режима. В справочнике API указаны текущая стоимость в кредитах, нужен ли API-ключ и цены за отдельные элементы.

Используется сотрудниками этих компаний

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse