Redirect Checker JSON-API

JSON-API für den Redirect-Checker

Die JSON-API liefert dir dasselbe Ergebnis wie der Redirect-Checker, nur maschinenlesbar – für Skripte, Monitoring und CI-Pipelines. Sie ist kostenlos und kommt ohne API-Key und ohne Registrierung aus.

GET https://redirect-tester.com/api.php?url=example.com&ua=googlebot

Parameter

Antwort

{
    "url": "http://example.com",
    "ua": "default",
    "result": {
        "hops": [
            { "url": "http://example.com", "status": 301, "time": 45, "type": "http", "error": null },
            { "url": "https://example.com/", "status": 200, "time": 120, "type": "http", "error": null }
        ],
        "error": null,
        "hints": [
            { "level": "info", "code": "hint.no_hsts", "text": "No Strict-Transport-Security (HSTS) header on the final URL." }
        ]
    },
    "error": null
}

• result.hops enthält alle Anfragen der Reihe nach. Der letzte Eintrag ist die finale URL.
  • status: der HTTP-Statuscode – oder null, wenn die Anfrage gescheitert ist (Timeout, DNS- oder TLS-Fehler). Dann steht der Grund in error.
  • time: Antwortzeit in Millisekunden.
  • type: http für eine normale HTTP-Antwort, meta, wenn diese Seite per Meta-Refresh weitergeleitet hat.
• result.error ist gesetzt, wenn die Prüfung abgebrochen wurde: bei einer Redirect-Schleife oder nach mehr als 10 Hops.
• result.hints enthält die Auswertung. level ist error, warning, info oder success. code ist ein stabiler Schlüssel, auf den du dich in deinem Code verlassen kannst: hint.final_error, hint.missing_location, hint.chain, hint.temporary, hint.meta_refresh, hint.no_https, hint.no_hsts, hint.ok. text ist eine lesbare Erklärung.
• error auf oberster Ebene ist gesetzt, wenn die Anfrage nicht verarbeitet werden konnte. result ist dann null.

Alle Texte in text und error sind englisch. Werte sie nicht per Textvergleich aus, sondern nutze code und die Statuscodes.

HTTP-Statuscodes der API

Limits

Jede Anfrage zählt als eine Prüfung. Das Limit liegt bei 60 Prüfungen pro IP-Adresse in 10 Minuten und gilt gemeinsam mit den Checkern auf der Website. CORS ist nicht aktiviert: Browser blockieren Aufrufe aus JavaScript auf anderen Websites. Ruf die API stattdessen von Servern, Skripten oder CI-Jobs aus auf.

Beispiele

curl

curl "https://redirect-tester.com/api.php?url=example.com&ua=googlebot"

curl und jq

# Statuscode der finalen URL
curl -s "https://redirect-tester.com/api.php?url=example.com" | jq '.result.hops[-1].status'

# Die ganze Kette, ein Hop pro Zeile
curl -s "https://redirect-tester.com/api.php?url=example.com" | jq -r '.result.hops[] | "\(.status) \(.url)"'

# Nur die Hint-Codes
curl -s "https://redirect-tester.com/api.php?url=example.com" | jq -r '.result.hints[].code'

PHP

<?php
$api = 'https://redirect-tester.com/api.php?' . http_build_query(['url' => 'example.com', 'ua' => 'googlebot']);
// ignore_errors: auch den JSON-Body von 4xx-Antworten lesen
$context = stream_context_create(['http' => ['ignore_errors' => true, 'timeout' => 30]]);
$data = json_decode(file_get_contents($api, false, $context), true, 512, JSON_THROW_ON_ERROR);

if ($data['error'] !== null) {
    exit('API-Fehler: ' . $data['error'] . PHP_EOL);
}
$hops = $data['result']['hops'];
$final = end($hops);
printf("%d Hop(s), finaler Status %s: %s\n", count($hops), $final['status'] ?? 'fehlgeschlagen', $final['url']);
foreach ($data['result']['hints'] as $hint) {
    echo "[{$hint['level']}] {$hint['code']}\n";
}

JavaScript (Node.js 18+)

const params = new URLSearchParams({ url: 'example.com', ua: 'chrome' });
const res = await fetch(`https://redirect-tester.com/api.php?${params}`);
const data = await res.json();
if (!res.ok) {
    throw new Error(`API ${res.status}: ${data.error}`);
}
const { hops, hints } = data.result;
console.log(hops.map((hop) => hop.status ?? 'fehlgeschlagen').join(' -> '));
console.log('Finale URL:', hops.at(-1).url);
console.log('Hinweise:', hints.map((hint) => hint.code));

CI-Check: Abbruch, wenn der finale Status nicht 200 ist

Dieses Shell-Skript prüft eine Liste von URLs, etwa nach einem Deployment oder einem Domainumzug, und bricht mit Fehler ab, sobald eine davon nicht auf 200 endet:

#!/bin/sh
set -eu

for url in example.com www.example.com http://example.com/alte-seite; do
    status=$(curl -fsS -G "https://redirect-tester.com/api.php" --data-urlencode "url=$url" \
        | jq -r '.result.hops[-1].status')
    if [ "$status" != "200" ]; then
        echo "FAIL $url: finaler Status $status" >&2
        exit 1
    fi
    echo "OK   $url"
done

Dank curl -f schlägt das Skript auch fehl, wenn die API selbst mit 4xx antwortet – zum Beispiel, weil das Rate-Limit erreicht ist. Halt die Liste also so kurz, dass du unter 60 Prüfungen in 10 Minuten bleibst. Für einmalige Listen ist der Bulk-Redirect-Checker der schnellere Weg.