Netcraft API Client

NetCraft API Client

Этот скрипт Python предоставляет интерфейс командной строки для взаимодействия с API NetCraft. Это позволяет пользователям выполнять различные действия, такие как отчет о злонамеренных URL -адресах, вредоносные электронные письма и неправильно заблокированные URL -адреса, а также получение подробностей о отправленных отчетах.

Функции

• Сообщите об одном URL
• Сообщите о нескольких URL -адресах из файла
• Сообщите о вредоносном письме (с дополнительным паролем для дешифрования)
• Сообщите о неправильно заблокированном URL
• Получите подробную информацию о представленном отчете
• Загрузить файлы, связанные с отправленным отчетом
• Получить URL -адреса, связанные с представленным отчетом
• Сообщите о проблеме с представленным отчетом (например, файлы или ошибочные классификации URL)
• Получите доступные теги для отчетов о файлах, почте или URL
• Отказаться от писем уведомлений

☕ Поддержите мою работу на KO-Fi

Предварительные условия

• Python 3.x
• requests библиотеки (установка с помощью pip install requests )

Присоединяйтесь к моему серверу Discord

Использование

1. Клонировать или загрузить репозиторий.
2. Перейдите к каталогу проекта.
3. Запустите скрипт с помощью python main.py
4. Следуйте подсказкам в интерфейсе командной строки, чтобы выполнить желаемые действия.

Пример использования: затем следуйте параметрам меню и предоставьте требуемые входы.

Функциональная документация

report_single_url(email, message, url)

Отчеты об одном URL -адресу Netcraft API.

• email : адрес электронной почты отправителя.
• message : дополнительное сообщение для включения в отчет.
• url : URL, который будет сообщен.

report_urls_from_file(email, message, file_path)

Сообщает несколько URL -адресов из файла в API NetCraft.

• email : адрес электронной почты отправителя.
• message : дополнительное сообщение для включения в отчет.
• file_path : путь к файлу, содержащему URL -адреса (один URL на строку).

report_malicious_mail(email, message, mail_content, password=None)

Сообщает злонамеренное электронное письмо в API NetCraft.

• email : адрес электронной почты отправителя.
• message : дополнительное сообщение для включения в отчет.
• mail_content : содержание вредоносного электронного письма в формате Mime.
• password : необязательный пароль для расшифровки электронной почты (если применимо).

report_incorrectly_blocked_url(email, url, reason)

Сообщает неправильно заблокированный URL -адрес для API NetCraft.

• email : адрес электронной почты отправителя.
• url : URL, который был неправильно заблокирован.
• reason : причина сообщения о неправильно заблокированном URL.

get_submission_details(uuid)

Получает подробную информацию о отправленном отчете и сохраняет их в файле JSON.

• uuid : UUID представленного отчета.

get_submission_files(uuid)

Загружает файлы, связанные с отправленным отчетом.

• uuid : UUID представленного отчета.

get_submission_urls(uuid)

Получает URL -адреса, связанные с представленным отчетом, и сохраняет их в файле JSON.

• uuid : UUID представленного отчета.

report_submission_issue(uuid, file_misclassifications, url_misclassifications, additional_info)

Сообщает вопрос с представленным отчетом, такой как ошибочные классификации файла или URL.

• uuid : UUID представленного отчета.
• file_misclassifications : список неправильно классифицированных имен файлов.
• url_misclassifications : список неправильно классифицированных URL -адресов.
• additional_info : дополнительная информация о проблеме.

get_available_tags(tag_type)

Получает доступные теги для отчетов о файлах, почте или URL.

• tag_type : тип тегов для retive ('file', 'mail' или 'url').

unsubscribe_from_notifications(email, csrf_token)

Отписывает предоставленный адрес электронной почты из электронных писем уведомлений.

• email : адрес электронной почты отказаться от подписки.
• csrf_token : токен CSRF, необходимый для отмены подписки.

Внося

Взносы приветствуются! Если вы найдете какие -либо проблемы или у вас есть предложения по улучшению, откройте проблему или отправьте запрос на привлечение.

Лицензия

Этот проект лицензирован по лицензии MIT.