> 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/fr/docs/redirect-chain

# Chaîne de redirection

API DomScan : 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.

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) |
| domain optionnel | string | Alias pour url lorsque vous avez uniquement un domaine nu. Le paramètre url a la priorité lorsque les deux sont fournis, et https:// est ajouté automatiquement. |

#### 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

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

```javascript
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}`);
});
```

```python
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

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