Panduan API untuk AI agent

URL dasar dan format permintaan

Permintaan menggunakan https://seohabit.com/api/v1. Kirim isi JSON dengan Content-Type: application/json. Proyek situs web dan progres pengajuan otomatis memerlukan autentikasi. Frekuensi permintaan dibatasi.

Pantau pengiriman dari pihak ketiga

Buat proyek dengan detail direktori yang diizinkan untuk memungkinkan pengiriman otomatis ke penyedia yang layak. Maksimal dua upaya per hari UTC, berhenti setelah lima direktori yang dikonfirmasi. SEOHabit memilih direktori yang layak di latar belakang; pengguna tidak membaca atau memilih daftar direktori. Jika tidak ada penyedia yang layak, proyek akan menunggu. Konfirmasi bukan publikasi atau tautan terverifikasi.

Periksa status tugas

Periksa URL status hingga pekerjaan mencapai completed atau failed. Autentikasi setiap periksa dengan token akses pekerjaan di header. Token pekerjaan hanya memberikan akses ke pekerjaan sendiri.

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

Respons berisi queued, running, completed, atau failed; result masih null hingga tersedia.

Akun, kunci proyek, dan tindakan berbayar

Pendaftaran dan login menetapkan cookie HttpOnly sh_session. Penulisan cookie browser diuji berdasarkan asal. Untuk integrasi, akun yang sudah login dapat membuat kunci API berbasis proyek dengan cakupan eksplisit dan mengirimkannya sebagai Authorization: Bearer shk_…. Kunci tidak dapat mengakses proyek lain, dan cakupan kunci membatasi operasi yang tersedia. Jaga kerahasiaan cookie sesi dan kunci API; tidak pernah sertakan dalam URL.

Tugas kata kunci menerima details.keyword, opsional details.language (default en) dan eksplisit details.pageUrl yang opsional. Saran menunjukkan bukti halaman yang sesuai dan menandai bahasa atau permintaan pencarian yang tidak diketahui.

Audit situs web dapat diatur pada proyek gratis hingga alokasi gratis. Pengawasan backlink, pembuatan tugas, dan eksekusi tugas memerlukan situs yang telah diverifikasi dan langganan aktif. Aksi berbayar memerlukan seseorang untuk membuktikan kepemilikan dan secara eksplisit memperoleh langganan melalui alur billing akun. Jangan mulai checkout, berlangganan, atau mengizinkan perubahan untuk situs orang lain. Eksekusi tugas bukan bukti bahwa perubahan telah diterapkan; tugas siap memerlukan pemeriksaan dan penerimaan pengguna.

Kunci proyek mendukung project:read, project:write, checks:write, dan tasks:write. Kunci hanya berlaku untuk proyeknya sendiri. Lihat Dokumen OpenAPI untuk rute dan format permintaan.

Error dan penggunaan aman

Kesalahan menggunakan JSON dengan error dan message. Respons umum termasuk 400 untuk input tidak valid atau URL tidak aman, 401 untuk keabsahan akun yang hilang, 403 untuk asal atau cakupan yang dilarang, 404 untuk sumber daya yang tidak tersedia, 409 untuk konflik, 429 untuk batas laju, dan 402 ketika aksi berbayar memerlukan langganan aktif.

Hanya periksa halaman publik yang telah diizinkan untuk diperiksa. Layanan ini memblokir tujuan privasi dan jaringan lokal, serta mengikuti kebijakan crawler situs sumber jika tersedia. Gunakan kunci idempotency untuk permintaan POST yang dapat diulang, dan tangani respons batas laju dengan backoff.