Dokumentacja dla deweloperów

Łańcuch przekierowań

Poznaj dokumentację API Łańcuch przekierowań, parametry żądań, pola odpowiedzi, przykłady kodu i obsługę błędów w integracjach DomScan.

Łańcuch przekierowań

Śledź łańcuchy przekierowań URL, aby wykrywać przejścia na HTTPS, zmiany domen i końcowe strony docelowe. Przydatne w analizie SEO, audytach bezpieczeństwa i rozumieniu routingu URL. Śledzi wszystkie przekierowania 3xx, w tym 301, 302, 303, 307 i 308.

GET /v1/redirects

Parametry zapytania

Parametr	Typ	Opis
url wymagane	string	Początkowy URL do śledzenia, np. "http://example.com"
max_redirects opcjonalne	number	Maksymalna liczba przekierowań, domyślnie 10, maksymalnie 20
domain opcjonalne	string	Alias dla url, gdy masz tylko domenę bare domain. Parametr url wygrywa, gdy dostarczone są oba, a https:// jest dodawany automatycznie.

Odpowiedź Fields

Pole	Typ	Opis
`original_url`	string	Podany początkowy URL
`final_url`	string	Końcowy URL po wszystkich przekierowaniach
`redirect_count`	number	Łączna liczba prześledzonych przekierowań
`https_upgrade`	boolean	Czy HTTP przełączono na HTTPS
`chain`	array	Każde przekierowanie z URL, kodem statusu i lokalizacją

Przykład Request

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/redirects?url=http://github.com"

const domscanFetch = (url, options = {}) =>
  fetch(url, {
    ...options,
    headers: { ...options.headers, "X-API-Key": "your-api-key" },
  });

const response = await domscanFetch(
  "https://domscan.net/v1/redirects?url=" + encodeURIComponent("http://github.com")
);
const data = await response.json();

console.log(`Final URL: ${data.final_url}`);
console.log(`Redirects: ${data.redirect_count}`);
console.log(`HTTPS upgrade: ${data.https_upgrade}`);

data.chain.forEach((hop, i) => {
  console.log(`${i + 1}. ${hop.status} ${hop.url} → ${hop.location}`);
});

import requests

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

from urllib.parse import quote

url = quote("http://github.com", safe='')
response = domscan.get(f"https://domscan.net/v1/redirects?url={url}")
data = response.json()

print(f"Final URL: {data['final_url']}")
print(f"HTTPS upgrade: {data['https_upgrade']}")
for i, hop in enumerate(data['chain']):
    print(f"{i+1}. [{hop['status']}] {hop['url']}")

Example Odpowiedź

{
  "original_url": "http://github.com",
  "final_url": "https://github.com/",
  "redirect_count": 1,
  "chain": [
    {
      "url": "http://github.com",
      "status": 301,
      "location": "https://github.com/",
      "response_time_ms": 45
    }
  ],
  "https_upgrade": true,
  "domain_change": false,
  "total_time_ms": 156
}