Skip to main content

Python client library for Domain Reputation API.

Project description

domain-reputation-py license domain-reputation-py release domain-reputation-py build

Overview

The client library for Domain Reputation API in Python language.

The minimum Python version is 3.6.

Installation

pip install domain-reputation

Examples

Full API documentation available here

Create a new client

from domainreputation import *

client = Client('Your API key')

Make basic requests

# Get DNS records for a domain name.
response = client.get('youtube.com')
print(response)

# Get raw API response in XML format
raw_result = client.get_raw('bbc.com',
    output_format=Client.XML_FORMAT)

Advanced usage

Extra request parameters

result = client.get(
    'samsung.com',
    Client.MODE_FULL)

Response model overview

Response:
    - mode: str
    - reputation_score: float
    - test_results: [TestResult]
        - test: str
        - test_code: int
        - warnings: [str]
        - warning_codes: [int]

Sample response

{
'mode': 'full',
'reputation_score': 81.16,
'test_results':
  [
      {
          "test": "Name servers configuration meets best practices",
          "testCode": 76,
          "warnings": [
              "Some name servers are located on a single ASN: \
               ns44.domaincontrol.com - AS44273, ns43.domaincontrol.com - AS44273"
          ],
          "warningCodes": [
              1013
          ]
      },
      {
          "test": "Mail servers configuration check",
          "testCode": 80,
          "warnings": [
              "AAAA records not configured for mail servers",
              "SPF record not configured",
              "DMARC is not configured"
          ],
          "warningCodes": [
              5007,
              5015,
              5016
          ]
      },
      {
          "test": "Malware databases check",
          "testCode": 82,
          "warnings": [
              "Status: dangerous"
          ],
          "warningCodes": [
              4001
          ]
      },
      {
          "test": "SSL Certificate configuration",
          "testCode": 89,
          "warnings": [
              "No SSL certificates found"
          ],
          "warningCodes": [
              6023
          ]
      }
  ]
}

Changelog

1.0.0 (2021-10-25)

  • First release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

domain-reputation-1.0.0.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

domain_reputation-1.0.0-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file domain-reputation-1.0.0.tar.gz.

File metadata

  • Download URL: domain-reputation-1.0.0.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.23.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for domain-reputation-1.0.0.tar.gz
Algorithm Hash digest
SHA256 1d7e3bec24f5e98bd81a2f3da69fa3ad8e74b5a2b85e4d5c8cb6806e885799a1
MD5 d2a3fe8f90c0be4c633ef1e73ed0f84b
BLAKE2b-256 c91d2d9662382f8619addfcaa139383fcc13a26b9dd1e2412caa0575247aa189

See more details on using hashes here.

File details

Details for the file domain_reputation-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: domain_reputation-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.23.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for domain_reputation-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4f47d473fd50cfa39da93c2b8fbf5aee4c49a2768bfbd56200e4c9022dd54118
MD5 f2e6d77732b8b4a569fbafbf61533283
BLAKE2b-256 c9ad64fc4afcacb74263aafcd68a6550056530f2e4ff9c0092d8b139e712b746

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page