Przewodnik API dla agentów

Podstawowy URL i format żądania

Żądania używają https://seohabit.com/api/v1. Wysyłaj treść JSON z Content-Type: application/json. Projekty witryn i postęp automatycznych zgłoszeń wymagają uwierzytelnienia. Częstotliwość żądań jest ograniczona.

Monitorowanie zadań zewnętrznych

Utwórz projekt z informacjami o katalogach, które są zatwierdzone, aby umożliwić automatyczne podanie do dostępnego dostawcy. W ciągu jednego dnia UTC dokonuje się maksymalnie dwóch prób, zatrzymując się po pięciu potwierdzonych katalogach. SEOHabit wybiera dostawców zgodnych w tle; użytkownicy nie przeglądarką ani nie wybierają listy katalogów. Jeśli nie będzie dostępnego dostawcy, projekt czeka. Potwierdzenie nie oznacza publikacji ani zatwierdzonego backlinku.

Sprawdzanie stanu zadania

Odpytuj adres URL statusu, aż zadanie osiągnie completed lub failed. Każde zapytanie uwierzytelniaj tokenem dostępu zadania w nagłówku. Token umożliwia dostęp wyłącznie do własnego zadania.

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

Odpowiedzi zawierają queued, running, completed lub failed; result jest puste do momentu dostępu.

Konta, klucze projektów i działania opłacane

Rejestracja i logowanie ustawiają cookie HttpOnly sh_session. Zapisy w plikach przeglądarki są sprawdzane na podstawie źródła. W przypadku integracji, zalogowany konto może stworzyć klucz API w zakresie projektu z wyraźnymi zakresami i przesłać go jako Authorization: Bearer shk_…. Klucze nie mogą dostępu do innych projektów, a zakresy kluczy ograniczają dostępne operacje. Trzymaj klucze sesji i klucze API prywatne; nigdy nie umieszczaj ich w adresach URL.

Zadania słów kluczowych przyjmują details.keyword, opcjonalne details.language (domyślnie en) oraz opcjonalne, jawnie wskazane details.pageUrl. Sugestie pokazują dowody z pasujących stron i oznaczają nieznany język lub nieznany popyt w wyszukiwarce.

Audyty stron mogą być zapisane na projekcie darmowym w zakresie darmowych limitów. Monitorowanie backlinków, tworzenie zadań i ich wykonanie wymagają zatwierdzonej strony i aktywnej subskrypcji. Operacja płatności wymaga, by osoba zainstalowała własność i wyraziła zgodę na subskrypcję przez proces fakturowania. Nie uruchamiaj procesu zakupu, nie subskrybuj ani nie udzielaj zezwolenia na zmiany dla innej osoby. Wykonanie zadania nie jest dowodem, że zmiana została zastosowana; gotowe zadanie wymaga sprawdzenia i akceptacji przez użytkownika.

Klucze projektów obsługują project:read, project:write, checks:write i tasks:write. Klucz dotyczy tylko własnego projektu. Zobacz dokument OpenAPI dla ścieżek i formularzy żądania.

Błędy i bezpieczne użycie

Błędy są przesyłane w formacie JSON z error i message. Typowe odpowiedzi to 400 dla nieprawidłowego wejścia lub niebezpiecznych URL, 401 dla braku autoryzacji konta, 403 dla zabronionego źródła lub zakresu, 404 dla niedostępnych zasobów, 409 dla konfliktów, 429 dla ograniczeń szybkości, a 402 gdy wymagana operacja płatności wymaga aktywnej subskrypcji.

Sprawdzaj tylko publiczne strony, do których masz uprawnienia do przeglądania. Usługa blokuje cele prywatne i sieci lokalne oraz przestrzega zasad krawlowania strony źródłowej, gdy są dostępne. Używaj kluczy idempotentnych dla zapytań POST, które mogą być ponownie wykonane, oraz obsługuj odpowiedzi z ograniczeniem szybkości z zastosowaniem odcięcia.