API-Anleitung für Agenten

Basierende URL und Anforderungsformat

Anfragen verwenden https://seohabit.com/api/v1. Senden Sie JSON-Anfragekörper mit Content-Type: application/json. Website-Projekte und der Fortschritt automatischer Einreichungen erfordern eine Authentifizierung. Anfragen unterliegen einer Ratenbegrenzung.

Dritte Parteieinreichungen verfolgen

Erstellen Sie ein Projekt mit autorisierten Direktverzeichnisdetails, um automatisierte Einreichungen an geeignete Anbieter zu ermöglichen. Bis zu zwei Versuche pro UTC-Tag werden durchgeführt, wobei nach fünf bestätigten Direktverzeichnissen gestoppt wird. SEOHabit wählt im Hintergrund geeignete Direktverzeichnisse aus; Benutzer können keine Liste durchscrollen oder auswählen. Falls kein geeigneter Anbieter verfügbar ist, wird das Projekt gewartet. Eine Bestätigung ist keine Veröffentlichung oder ein bestätigter Backlink.

Auftragsstatus abfragen

Pollen Sie den Status-URL, bis die Aufgabe completed oder failed erreicht. Authentifizieren Sie jede Abfrage mit dem Auftrags-Token im Header. Ein Auftrags-Token gewährt nur Zugriff auf seine eigene Aufgabe.

curl 'https://seohabit.com/api/v1/jobs/job_example' \
  -H 'X-Access-Token: YOUR_JOB_ACCESS_TOKEN'

Antworten enthalten queued, running, completed oder failed; result ist null, bis verfügbar.

Konten, Projekt-Schlüssel und bezahlte Aktionen

Die Kontoinformationen und Anmeldung setzen einen HttpOnly-sh_session-Cookie. Browser-Cookie-Updates werden quellbasiert überprüft. Bei Integrationsanfragen kann ein angemeldeter Account ein projektbezogenes API-Schlüssel mit expliziten Berechtigungen erstellen und als Authorization: Bearer shk_… übermitteln. Die Schlüssel können keinen anderen Projektzugriff erlangen, und die Berechtigungen des Schlüssels begrenzen die verfügbaren Aktionen. Halten Sie Sitzungs-Cookies und API-Schlüssel geheim; legen Sie sie nie in URLs fest.

Keyword-Aufgaben akzeptieren details.keyword, optional details.language (Standard en) und eine optionale explizite details.pageUrl. Vorschläge zeigen passende Seitenbelege und markieren unbekannte Sprache oder Suchanfragen.

Website-Audits können auf einem kostenlosen Projekt innerhalb der kostenlosen Zulassungen eingereicht werden. Die Überwachung von Backlinks, die Erstellung von Aufgaben und die Ausführung von Aufgaben erfordern eine bestätigte Website und ein aktives Abonnement. Eine bezahlte Aktion erfordert, dass eine Person die Eigentumsrechte bestätigt und explizit über die Abonnementabrechnung im Konto-Abrechnungsfluss erlangt. Starten Sie keine Bestellung, Abonnement oder Änderungen für eine Website auf jemand Elternschaft. Die Ausführung einer Aufgabe ist keine Bestätigung, dass eine Änderung angewendet wurde; eine bereitgestellte Aufgabe erfordert eine Benutzerprüfung und Akzeptanz.

Projektkeys unterstützen project:read, project:write, checks:write und tasks:write. Ein Schlüssel gilt nur für sein eigenes Projekt. Weitere Informationen finden Sie im OpenAPI-Dokument zu Routen und Anfragenstrukturen.

Fehler und sichere Nutzung

Fehler werden in JSON mit error und message dargestellt. Typische Antworten umfassen 400 für ungültige Eingaben oder unsichere URLs, 401 für fehlende Authentifizierung, 403 für eine verbotene Quelle oder Berechtigung, 404 für nicht verfügbare Ressourcen, 409 für Konflikte, 429 für Rate-Limits und 402, wenn eine bezahlte Aktion ein aktives Abonnement erfordert.

Prüfen Sie nur öffentliche Seiten, die Ihnen ausdrücklich zugelassen sind. Der Dienst blockiert private und lokale Netzwerkkontrollpunkte und befolgt die Crawlerpolitik der Quellseite, falls verfügbar. Verwenden Sie Idempotenzschlüssel für wiederholbare POST-Anfragen und behandeln Sie Antworten mit Rate-Limit mit Backoff.