Guida API per agenti

URL di base e formato della richiesta

Le richieste utilizzano https://seohabit.com/api/v1. Invia corpi JSON con Content-Type: application/json. I progetti dei siti web e lo stato degli invii automatici richiedono autenticazione. La frequenza delle richieste è limitata.

Tracciare le spedizioni di terze parti

Crea un progetto con dettagli della directory autorizzata per abilitare l'invio automatico ai fornitori idonei. Sono massimo due tentativi al giorno UTC, che si interrompono dopo cinque directory riconosciute. SEOHabit seleziona le directory idonee in background; gli utenti non esplorano o selezionano una lista di directory. Se non è disponibile un fornitore idoneo, il progetto aspetta. Un riconoscimento non costituisce pubblicazione né un backlink verificato.

Interroga lo stato del processo

Polla lo stato dell'URL fino a quando il job raggiunge completed o failed. Autentica ogni richiesta con il token del job nell'intestazione. Un token di job concede l'accesso soltanto al proprio job.

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

Le risposte includono queued, running, completed, o failed; result è nullo fino al suo disponibilità.

Account, chiavi di progetto e azioni pagate

L'iscrizione e l'accesso impostano un cookie HttpOnly sh_session. Le scritture dei cookie del browser vengono verificate per origine. Per integrazioni, un account autenticato può creare una chiave API a livello di progetto con ambiti espliciti e inviarla come Authorization: Bearer shk_…. Le chiavi non possono accedere a progetti diversi e gli ambiti delle chiavi limitano le operazioni disponibili. Conserva i cookie di sessione e le chiavi API segreti; non includerle mai in URL.

Le attività di keyword accettano details.keyword, opzionale details.language (valore predefinito en) e un'opzione esplicita details.pageUrl. Le suggerimenti mostrano prove di pagina corrispondente e segnalano linguaggio sconosciuto o domanda di ricerca non valida.

Gli audit del sito possono essere programmati su un progetto gratuito entro il limite gratuito. I backlink monitorati, la creazione di compiti e l'esecuzione richiedono un sito verificato e una sottoscrizione attiva. Una azione pagata richiede che una persona stabilisca l'ownership e ottenga esplicitamente la sottoscrizione tramite il flusso di fatturazione dell'account. Non avvii il checkout, non sottoscrivi o non autorizzi modifiche per un altro. L'esecuzione di un compito non è prova che una modifica sia stata applicata; un compito pronto richiede la revisione e l'approvazione dell'utente.

I progetti chiave supportano project:read, project:write, checks:write e tasks:write. Un token si applica soltanto al proprio progetto. Vedere il Documento OpenAPI per le rotte e le forme delle richieste.

Errori e uso sicuro

Gli errori usano JSON con error e message. Risposte comuni includono 400 per input non valido o URL non sicuri, 401 per mancanza di autenticazione dell'account, 403 per origine non consentita o ambito non autorizzato, 404 per risorse non disponibili, 409 per conflitti, 429 per limiti di velocità e 402 quando un'azione pagata richiede una sottoscrizione attiva.

Solo esegui controlli su pagine pubbliche a cui hai accesso. Il servizio blocca destinazioni private e di rete locale e segue la politica del crawler del sito originale quando disponibile. Usa chiavi idempotenti per richieste POST ripetibili e gestisci le risposte di limite di velocità con ritardo.