Was Ihnen die Verbindung bringt
Wenn Sie Ihren eigenen Ahrefs-Schlüssel verbinden, werden die SEO-Daten für Ihre Websites über Ihr Ahrefs-Konto statt über unseres abgerufen. Sie sehen dieselben Messwerte in Ihrem Dashboard, bezogen aus Ihrem eigenen Abonnement.
Bevor Sie beginnen
Ein Ahrefs-Tarif mit API-Zugriff sowie Inhaber- oder Administratorrechte für den Ahrefs-Workspace — nur diese Personen können API-Schlüssel erstellen.
1. Schlüssel bei Ahrefs erstellen
Öffnen Sie in Ahrefs Account settings → API keys und erstellen Sie einen Schlüssel. Jeder Schlüssel ist ein Jahr lang gültig und funktioniert danach nicht mehr; die Seite zeigt das jeweilige Ablaufdatum an. Auf derselben Seite können Sie auch festlegen, wie viele API-Einheiten ein Schlüssel pro Monat maximal verbrauchen darf.
2. Hier verbinden
Öffnen Sie Integrationen in Ihrem Dashboard und wählen Sie Konto verbinden. Wählen Sie Eigene SEO-Daten als Gruppe und Ahrefs als Konto, tragen Sie den API-Schlüssel ein und klicken Sie auf Konto verbinden.
Wir testen Ihre Eingabe, bevor etwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Rückmeldung gibt an, was daran fehlerhaft war. Ein funktionierender Schlüssel wird verschlüsselt in unserem Geheimnis-Tresor aufbewahrt — niemals in unserer Datenbank — und wird nie wieder angezeigt, nicht einmal Ihnen selbst.
Was als Nächstes passiert
- Die Authority- und Backlink-Prüfungen, die wir für Ihre Websites durchführen, nutzen Ihren Schlüssel über das Kontingent Ihres Tarifs und verwenden unseren nicht mehr. Für Prüfungen, die über Ihren Schlüssel laufen, stellen wir Ihnen nichts in Rechnung.
- Wenn Ihr Schlüssel widerrufen wird oder sein Kontingent erschöpft ist, halten wir an und weisen Sie darauf hin — auf den Bildschirmen, auf denen die Messwerte erscheinen —, anstatt unbemerkt zu unserem Konto zurückzuwechseln. Korrigieren Sie den Schlüssel beim Anbieter oder trennen Sie die Verbindung, um wieder den in Ihrem Tarif enthaltenen Umfang zu nutzen.
- Prüfungen werden nach ihrem normalen Zeitplan ausgeführt; das Verbinden eines Schlüssels löst keine plötzliche Flut von Abrufen zu Lasten Ihres Kontingents aus.
Wenn keine Verbindung hergestellt werden kann
Er funktioniert nach einem Jahr nicht mehr. Ahrefs-Schlüssel laufen nach zwölf Monaten ab. Erstellen Sie einen neuen Schlüssel und verbinden Sie ihn.
Prüfungen brechen mit einer Limit-Meldung ab. Die monatliche API-Einheiten-Begrenzung des Schlüssels oder das Kontingent Ihres Tarifs ist aufgebraucht. Erhöhen Sie die Begrenzung unter Account settings → API keys oder warten Sie auf die Verlängerung.
Es wird gemeldet, dass der Schlüssel abgelehnt wurde. Fast immer liegt das an einem von drei Gründen: Ein Leerzeichen oder Zeilenumbruch wurde mitkopiert, der Schlüssel ist abgelaufen oder er wurde widerrufen bzw. neu generiert, nachdem Sie ihn kopiert haben. Erstellen Sie einen neuen Schlüssel und fügen Sie ihn erneut ein.
Die Verbindung gelingt, aber später schlägt etwas fehl. Der Schlüssel authentifiziert sich, verfügt jedoch nicht über eine Berechtigung, die für die Aktion erforderlich ist. Erstellen Sie einen neuen Schlüssel mit den oben genannten Berechtigungen, trennen Sie dann die alte Verbindung und verbinden Sie den neuen Schlüssel.
Verbindung trennen
Öffnen Sie Integrationen, suchen Sie das Konto und klicken Sie auf Trennen. Dadurch wird der gespeicherte Schlüssel sofort gelöscht. Alles, was ihn genutzt hat, stoppt bei der nächsten Aktion, und die davon abhängigen Bildschirme weisen darauf hin, anstatt stillschweigend zu versagen.
Das Trennen der Verbindung macht bereits Durchgeführtes nicht rückgängig — Datensätze, Bereitstellungen oder Einstellungen, die wir in Ihrem Konto geändert haben, bleiben unverändert. Wenn Sie vermuten, dass der Schlüssel selbst kompromittiert wurde, widerrufen Sie ihn zusätzlich beim Anbieter; das Trennen entfernt lediglich unsere Kopie, nicht die des Anbieters.