Référence Développeur

Chaîne de redirection

Consultez la documentation de l'API Chaîne de redirection, ses paramètres de requête, les champs de réponse, les exemples de code et la gestion des erreurs pour les intégrations DomScan.

Chaîne de redirection

Suivez les chaînes de redirection d'URL pour détecter les mises à niveau HTTPS, les changements de domaine et les pages d'atterrissage finales. Utile pour l'analyse SEO, l'audit de sécurité et la compréhension du routage d'URL. Suit toutes les redirections 3xx incluant 301, 302, 303, 307 et 308.

GET /v1/redirects

Paramètres de Requête

Paramètre	Type	Description
url requis	string	URL de démarrage à suivre (par exemple, "http://example.com")
max_redirects optionnel	number	Redirections maximales à suivre (par défaut : 10, max : 20)

Champs de Réponse

Champ	Type	Description
`original_url`	string	URL de démarrage qui a été fournie
`final_url`	string	URL finale après toutes les redirections
`redirect_count`	number	Nombre total de redirections suivies
`https_upgrade`	boolean	Si HTTP a été mis à niveau vers HTTPS
`chain`	array	Chaque redirection avec URL, code d'état, localisation

Exemple de Requête

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']}")

Exemple de Réponse

{
  "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
}