> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/sv/docs/vulnerabilities

# Sårbarhetsanalys

Utforska API-dokumentationen för Sårbarhetsanalys, anropsparametrar, svarsfält, kodexempel och felhantering för DomScan-integrationer.

Granska en offentlig sida efter signaler om programvara och säkerhetskonfiguration och jämför sedan komponenter som stöds och har ett identifierat versionsnummer med säkerhetsmeddelanden för paket och data om exploatering. Resultaten visar belägg och täckning för de kontroller som slutförts. Ett rent resultat bevisar inte att programmet är fritt från sårbarheter.

GET /v1/vulnerabilities

#### Frågeparametrar

| Parameter | Typ | Description |
| --- | --- | --- |
| url valfri | string | Fullständig offentlig HTTP(S)-URL att analysera. Om både URL och domain anges har URL företräde. |
| domain valfri | string | Offentlig domän eller HTTP(S)-URL att analysera. Ange antingen URL eller domain. |
| mode valfri | string `standard` \| `deep` | Skanningsläge: standard är standard och kostar 8 krediter, deep lägger till isolerad JavaScript-rendering och kostar 12 krediter. Inget annat värde accepteras. |

#### Rådgivningskällor och täckning

Korrelera verifierade offentliga teknikversioner med auktoritativa paketråd, känd exploatering och exploateringssannolikhet. DomScan håller berörda versioner, felaktiga säkerhetskonfigurationer och okänd täckning åtskilda så att team kan åtgärda de starkaste beläggen först.

| Fält | Description |
| --- | --- |
| `checked` | Källan frågades och resultatet återspeglas i resultaten. |
| `not_requested` | Det fanns ingenting att fråga källan. Ingen identifierad komponent bar en version mappad till ett granskningspaket, så ingen rådgivning frågades och ingen CVE nådde exploiteringskällorna. Detta är en täckningsgräns, inte bevis på att målet är opåverkat. |
| `partial` / `failed` | Källan frågades men svarade ofullständigt eller inte alls. Påverkade komponenter förblir okända och rapporteras aldrig som säkra. |

#### Exempelbegäran

```bash
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/vulnerabilities?domain=example.com&mode=standard"   -H "x-api-key: YOUR_API_KEY"
```

```python
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.get(
    "https://domscan.net/v1/vulnerabilities",
    params={"domain": "example.com", "mode": "deep"},
    headers={"x-api-key": "YOUR_API_KEY"},
)
result = response.json()

print(result["summary"]["posture"])
print(result["coverage"]["package_advisories"])
```

#### Svarsfält

| Fält | Typ |
| --- | --- |
| `target` | object |
| `target.requested_url` | string |
| `target.final_url` | string |
| `target.hostname` | string |
| `scan` | object |
| `scan.mode` | string |
| `scan.status` | string |
| `scan.checked_at` | string |
| `scan.duration_ms` | integer |
| `scan.disclaimer` | string |
| `summary` | object |
| `summary.posture` | string |
| `summary.risk_level` | string |
| `summary.finding_count` | integer |
| `summary.version_affected_count` | integer |
| `summary.misconfiguration_count` | integer |
| `summary.urgent_count` | integer |
| `summary.severity_counts` | object |
| `findings[]` | object[] |
| `findings[]` | object |
| `findings[].fingerprint` | string |
| `findings[].classification` | string |
| `findings[].severity` | string |
| `findings[].priority` | string |
| `findings[].title` | string |
| `findings[].summary` | string |
| `findings[].component` | object |
| `findings[].component.technology_id` | string |
| `findings[].component.name` | string |
| `findings[].component.detected_version` | string |
| `findings[].component.version_kind` | string |
| `findings[].component.confidence` | string |
| `findings[].component.confidence_score` | integer |
| `findings[].component.ecosystem` | string |
| `findings[].component.package` | string |
| `findings[].component.purl` | string |
| `findings[].advisory` | object |
| `findings[].advisory.id` | string |
| `findings[].advisory.aliases[]` | string[] |
| `findings[].advisory.cves[]` | string[] |
| `findings[].advisory.published_at` | string \| null |
| `findings[].advisory.modified_at` | string \| null |
| `findings[].advisory.cvss[]` | object[] |
| `findings[].advisory.cvss[]` | object |
| `findings[].advisory.cvss[].type` | string |
| `findings[].advisory.cvss[].vector` | string |
| `findings[].advisory.fixed_versions[]` | string[] |
| `findings[].advisory.affected_ranges[]` | object[] |
| `findings[].advisory.affected_ranges[]` | object |
| `findings[].advisory.references[]` | string[] |
| `findings[].exploitation` | object |
| `findings[].exploitation.cisa_kev` | boolean \| null |
| `findings[].exploitation.kev_added_at` | string \| null |
| `findings[].exploitation.kev_required_action` | string \| null |
| `findings[].exploitation.known_ransomware_use` | string \| null |
| `findings[].exploitation.epss_probability` | number \| null |
| `findings[].exploitation.epss_percentile` | number \| null |
| `findings[].exploitation.epss_date` | string \| null |
| `findings[].evidence` | object |
| `findings[].evidence.confidence` | string |
| `findings[].evidence.observed[]` | string[] |
| `findings[].evidence.limitations[]` | string[] |
| `findings[].remediation` | object |
| `findings[].remediation.summary` | string |
| `findings[].remediation.fixed_versions[]` | string[] |
| `findings[].sources[]` | string[] |
| `components[]` | object[] |
| `components[]` | object |
| `components[].technology_id` | string |
| `components[].name` | string |
| `components[].detected_version` | string \| null |
| `components[].version_kind` | string \| null |
| `components[].confidence` | string |
| `components[].advisory_status` | string |
| `components[].matched_advisories` | integer |
| `coverage` | object |
| `coverage.target_response` | string |
| `coverage.technology_detection` | string |
| `coverage.package_advisories` | string |
| `coverage.known_exploitation` | string |
| `coverage.exploitation_probability` | string |
| `coverage.detected_components` | integer |
| `coverage.versioned_components` | integer |
| `coverage.advisory_eligible_components` | integer |
| `coverage.advisory_checked_components` | integer |
| `coverage.advisory_deferred_components` | integer |
| `coverage.advisory_query_limit` | integer |
| `coverage.relay_used` | boolean |
| `coverage.limitations[]` | string[] |
| `sources[]` | object[] |
| `sources[]` | object |
| `sources[].id` | string |
| `sources[].name` | string |
| `sources[].owner` | string |
| `sources[].url` | string |
| `sources[].status` | string |
| `sources[].retrieved_at` | string \| null |
| `sources[].cache_hit` | boolean |
| `sources[].expected_freshness` | string |
| `sources[].fallback_behavior` | string |
| `sources[].cost` | string |
| `_meta` | object |

#### Exempelsvar

```json
{
  "target": {
    "requested_url": "https://www.example.com/",
    "final_url": "https://www.example.com/",
    "hostname": "www.example.com"
  },
  "scan": {
    "mode": "standard",
    "status": "complete",
    "checked_at": "2026-10-09T10:15:30.000Z",
    "duration_ms": 3120,
    "disclaimer": "A clean result means DomScan did not detect an issue within the documented scan coverage. Automated scanning cannot prove that an application is vulnerability-free or replace an authorized penetration test."
  },
  "summary": {
    "posture": "review",
    "risk_level": "medium",
    "finding_count": 2,
    "version_affected_count": 0,
    "misconfiguration_count": 2,
    "urgent_count": 0,
    "severity_counts": {
      "critical": 0,
      "high": 0,
      "medium": 1,
      "low": 1,
      "info": 0,
      "unknown": 0
    }
  },
  "findings": [
    {
      "fingerprint": "configuration:content-security-policy:www.example.com",
      "classification": "security_misconfiguration",
      "severity": "medium",
      "priority": "elevated",
      "title": "Content Security Policy is not advertised",
      "summary": "The observed response did not include a Content-Security-Policy header.",
      "evidence": {
        "confidence": "high",
        "observed": [
          "Public response did not include the expected content-security-policy protection."
        ],
        "limitations": [
          "header_policy_can_vary_by_path_or_response_status"
        ]
      },
      "remediation": {
        "summary": "Deploy a restrictive Content Security Policy in report-only mode first, then enforce it.",
        "fixed_versions": []
      },
      "sources": [
        "target_response"
      ]
    },
    {
      "fingerprint": "configuration:referrer-policy:www.example.com",
      "classification": "security_misconfiguration",
      "severity": "low",
      "priority": "normal",
      "title": "Referrer Policy is not advertised",
      "summary": "The response did not include an explicit Referrer-Policy header.",
      "evidence": {
        "confidence": "high",
        "observed": [
          "Public response did not include the expected referrer-policy protection."
        ],
        "limitations": [
          "header_policy_can_vary_by_path_or_response_status"
        ]
      },
      "remediation": {
        "summary": "Choose and deploy a Referrer-Policy that matches the application privacy and analytics requirements.",
        "fixed_versions": []
      },
      "sources": [
        "target_response"
      ]
    }
  ],
  "components": [
    {
      "technology_id": "jquery",
      "name": "jQuery",
      "detected_version": "3.7.1",
      "version_kind": "asset",
      "confidence": "high",
      "advisory_status": "checked",
      "matched_advisories": 0
    },
    {
      "technology_id": "cloudflare",
      "name": "Cloudflare",
      "detected_version": null,
      "version_kind": null,
      "confidence": "high",
      "advisory_status": "mapping_unavailable",
      "matched_advisories": 0
    }
  ],
  "coverage": {
    "target_response": "checked",
    "technology_detection": "checked",
    "package_advisories": "checked",
    "known_exploitation": "not_requested",
    "exploitation_probability": "not_requested",
    "detected_components": 2,
    "versioned_components": 1,
    "advisory_eligible_components": 1,
    "advisory_checked_components": 1,
    "advisory_deferred_components": 0,
    "advisory_query_limit": 20,
    "relay_used": true,
    "limitations": [
      "Only exact reviewed technology-to-package mappings are checked against OSV.",
      "Versionless or semantically incompatible detections are not reported as vulnerable.",
      "This passive scan does not send exploit payloads or prove exploitability.",
      "Response headers and exposed versions can vary by path, edge location, or authentication state."
    ]
  },
  "sources": [
    {
      "id": "target_response",
      "name": "Observed public response",
      "owner": "Target website",
      "url": "https://domscan.net/tech-stack-api",
      "status": "checked",
      "retrieved_at": "2026-10-09T10:15:30.000Z",
      "cache_hit": false,
      "expected_freshness": "Live at scan time",
      "fallback_behavior": "Unavailable signals remain unknown and never imply that the target is unaffected",
      "cost": "none"
    },
    {
      "id": "osv",
      "name": "OSV",
      "owner": "Google Open Source Security Team",
      "url": "https://google.github.io/osv.dev/",
      "status": "checked",
      "retrieved_at": "2026-10-09T10:15:29.000Z",
      "cache_hit": false,
      "expected_freshness": "OSV targets advisory freshness within 15 minutes",
      "fallback_behavior": "Use a fresh cached result when available; otherwise mark the component advisory check unknown",
      "cost": "none"
    },
    {
      "id": "cisa_kev",
      "name": "CISA Known Exploited Vulnerabilities Catalog",
      "owner": "Cybersecurity and Infrastructure Security Agency",
      "url": "https://www.cisa.gov/known-exploited-vulnerabilities-catalog",
      "status": "not_requested",
      "retrieved_at": null,
      "cache_hit": false,
      "expected_freshness": "Catalog changes are checked hourly",
      "fallback_behavior": "Use a fresh cached catalog when available; otherwise leave exploitation status unknown",
      "cost": "none"
    },
    {
      "id": "first_epss",
      "name": "Exploit Prediction Scoring System",
      "owner": "FIRST",
      "url": "https://www.first.org/epss/",
      "status": "not_requested",
      "retrieved_at": null,
      "cache_hit": false,
      "expected_freshness": "Scores are generated daily",
      "fallback_behavior": "Return the advisory without an EPSS value and mark exploitation probability unknown",
      "cost": "none"
    }
  ],
  "_meta": {
    "served_by": "pop=MAD country=ES",
    "analysis_status": "complete"
  }
}
```

**Täckning och källor:**
Ett resultat utan fynd kan inte bevisa att en applikation är fri från sårbarheter eller ersätta ett auktoriserat penetrationstest.
