Wie es funktioniert

Ahrefs Connect ermöglicht es Ihrer App, im Namen eines Nutzers, der sein Ahrefs-Konto mit Ihrem Produkt verbindet, auf Ahrefs-API-Daten zuzugreifen.

So läuft es grundsätzlich ab:

1. Ihre App integriert die Ahrefs API über OAuth.
2. Ein gemeinsamer Nutzer mit einem kostenpflichtigen Ahrefs-Abo verbindet sein Konto mit Ihrer App.
3. Ihre App fragt Ahrefs-Daten im Namen dieses Nutzers ab.
4. Jede Anfrage verbraucht API-Einheiten aus dem monatlichen Kontingent dieses Nutzers.
5. Sie verarbeiten, speichern und zeigen diese Daten in Ihrer App für diesen Nutzer an.

Teilnahmevoraussetzungen

Um an Ahrefs Connect teilzunehmen, muss Ihre App:

• Ein öffentlich verfügbares Produkt mit einer bestehenden Nutzerbasis sein. Wenn Sie Ahrefs-Daten für den privaten oder internen Gebrauch benötigen, sollten Sie stattdessen direkt die Ahrefs API verwenden.
• nicht direkt mit Ahrefs konkurrieren oder unsere Funktionen kopieren.
• Daten nur im Namen einzelner Ahrefs-Nutzer mit kostenpflichtigen Konten abfragen. Ahrefs Connect ist nicht für Produkte gedacht, die Ahrefs-Daten einem allgemeinen Publikum anzeigen möchten, ohne dass jeder Betrachter ein Ahrefs-Nutzer ist.

Ablauf

1. Anwendung

Reichen Sie das Bewerbungsformular mit folgenden Angaben ein:

• Eine Beschreibung Ihres Produkts
• Einen Link zu Ihrer Website
• Details dazu, wie Sie Ahrefs-Daten in Ihrer App nutzen möchten

Unser Enterprise-Team bestätigt, ob Ihr Produkt die Voraussetzungen erfüllt, erklärt den Ablauf und unterstützt Sie dabei.

2. Enterprise Plan

Wenn Sie eine neue Integration entwickeln (nicht Teil des Legacy-Programms), benötigen Sie einen Ahrefs Enterprise-Plan, um Ihre Integration in der Produktionsumgebung zu aktivieren.

• Während der Entwicklung benötigen Sie den Plan nicht.
• Er ist erforderlich, um die Integration für Live-Nutzer zu aktivieren.

Unser Vertriebsteam begleitet Sie durch diesen Schritt.

3. Entwicklung

Sobald alles eingerichtet ist, finden Sie Ihren Bereich Ahrefs Connect in den Kontoeinstellungen. Diese Seite enthält Details zur OAuth-Implementierung:

• Client-IDs und Secrets
• Felder zum Festlegen der Redirect URIs für Staging- und Produktionsumgebungen

In diesem Stadium hat Ihre App den Status Inaktiv, sodass Sie:

• OAuth-Flows in Ihrer Staging-Umgebung testen können
• Kostenlose Testanfragen an API-v3-Endpunkte stellen können

Ressourcen:

• API-v3-Dokumentation
• Kostenlose Testanfragen
• Leitfaden zur OAuth-Implementierung

Wenn Sie während der Entwicklung Fragen haben, wenden Sie sich an [email protected] oder an den Sales Manager, mit dem Sie in Kontakt waren.

4. Bewertung

Wenn die Entwicklung abgeschlossen ist, informieren Sie unser Support- oder Vertriebsteam. Sie geben Ihnen Anweisungen zur Einreichung und Details zu den Voraussetzungen für die Genehmigung.

Weitere Infos: Genehmigungsprozess

5. Aktivierung

Nach der Genehmigung wechselt Ihre App auf Aktiv. Dadurch wird Folgendes ermöglicht:

• Live-OAuth-Verbindungen für Ahrefs-Nutzer in der Produktionsumgebung
• Voller Zugriff auf API-Anfragen in der Produktionsumgebung

Unser Vertriebsteam kann Ihre App außerdem zur App-Galerie hinzufügen, damit Nutzer sie leicht finden können. Dazu müssen zusätzliche Listing-Details bereitgestellt werden: Apps-Galerie-Leitfaden