AI agent için API rehberi

Temel URL ve istek formatı

İstekler https://seohabit.com/api/v1 kullanır. JSON gövdelerini Content-Type: application/json ile gönderin. Web sitesi projeleri ve otomatik gönderim ilerlemesi kimlik doğrulama gerektirir. İstek sıklığı sınırlıdır.

Üçüncü parti gönderimlerini takip et

Uygun sağlayıcılara otomatik gönderimi etkinleştirmek için yetkilendirdiğiniz dizin bilgileriyle bir proje oluşturun. UTC gününde en fazla iki deneme yapılır ve beş dizin alındı bildirimi verdiğinde gönderimler durur. SEOHabit uygun dizinleri arka planda seçer; kullanıcılar bir dizin listesine göz atmaz veya listeden seçim yapmaz. Uygun sağlayıcı yoksa proje bekler. Alındı bildirimi, yayımlanma veya doğrulanmış geri bağlantı anlamına gelmez.

İş durumunu sorgula

Görev completed veya failed durumuna ulaşana kadar durum URL’sini sorgulayın. Her sorguda üst bilgi üzerinden görevin erişim belirteciyle kimlik doğrulayın. Bir görev belirteci yalnızca kendi görevine erişim verir.

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

Cevaplar queued, running, completed veya failed içerebilir; result henüz mevcut değildir.

Hesaplar, proje anahtarları ve ödenmiş eylemler

Hesap oluşturma ve oturum açma işlemleri, HttpOnly özelliğine sahip bir sh_session çerezi oluşturur. Tarayıcıdan çerez kullanan yazma isteklerinin kaynağı denetlenir. Entegrasyonlar için oturum açmış bir hesap, açıkça belirlenmiş izin kapsamlarıyla projeye özel bir API anahtarı oluşturabilir ve bunu Authorization: Bearer shk_… olarak gönderebilir. Anahtarlar başka projelere erişemez; izin kapsamları kullanılabilecek işlemleri sınırlar. Oturum çerezlerini ve API anahtarlarını gizli tutun; bunları URL’lere eklemeyin.

Anahtar kelime görevleri details.keyword, isteğe bağlı details.language (varsayılan en) ve isteğe bağlı, açıkça belirtilmiş bir details.pageUrl kabul eder. Öneriler, eşleşen sayfa kanıtlarını gösterir ve bilinmeyen dil veya arama talebi bilgilerini belirtir.

Web sitesi denetimleri, ücretsiz proje kotası dahilinde kuyruğa alınabilir. Geri bağlantı izleme, görev oluşturma ve görev yürütme, doğrulanmış bir site ve etkin abonelik gerektirir. Ücretli bir işlem için bir kişinin site sahipliğini kanıtlaması ve hesap faturalandırma akışından açıkça abonelik edinmesi gerekir. Başkası adına ödeme başlatmayın, abone olmayın veya bir siteye değişiklik yetkisi vermeyin. Görevin yürütülmesi, değişikliğin uygulandığının kanıtı değildir; hazır bir görev kullanıcı incelemesi ve kabulü gerektirir.

Proje anahtarları project:read, project:write, checks:write ve tasks:write destekler. Bir anahtar sadece kendi projesi için geçerlidir. Yol ve istek şekilleri için OpenAPI belgesi’ı inceleyin.

Hatalar ve güvenli kullanım

Hatalar, error ve message alanlarını içeren JSON biçiminde döner. Yaygın yanıtlar: geçersiz girdi veya güvenli olmayan URL’ler için 400, eksik hesap kimlik doğrulaması için 401, izin verilmeyen kaynak veya kapsam için 403, kullanılamayan kaynaklar için 404, çakışmalar için 409, istek sınırları için 429 ve ücretli bir işlem etkin abonelik gerektirdiğinde 402.

Yalnızca incelemeye yetkili olduğunuz herkese açık sayfaları kontrol edin. Hizmet, özel ve yerel ağ hedeflerini engeller ve mevcut olduğunda kaynak sitenin tarama politikasına uyar. Yeniden denenebilen POST isteklerinde idempotency anahtarları kullanın ve istek sınırı yanıtlarında bekleme sürelerini artırarak tekrar deneyin.