API di indicizzazione

01 Accesso su richiesta

Quasi tutto quello che il servizio fa passa dalla dashboard: incolli una lista, avvii l'ordine, guardi come finisce. Copre la gran parte dei casi. Per questo la porta leggibile dalle macchine resta stretta e la apriamo agli account che ne hanno davvero bisogno.

Quello che segue è l'intera superficie così com'è progettata. È corta, e se ti manca qualcosa scrivici. Un endpoint che la gente chiama davvero vale più di dieci che non chiama nessuno.

02 Che forma ha

REST su HTTPS, JSON in entrata e JSON in uscita, una chiave in un header, nessun SDK da installare. Qualsiasi cosa sappia fare una richiesta HTTP la può pilotare.

• Una chiave per account. Rilasciata a te, ruotata o revocata su richiesta.
• Un header. Nessuna firma, nessun balletto OAuth, nessun token da rinnovare.
• Gli stessi oggetti che vedi già. Un ordine creato via API è l'ordine che sta nella tua dashboard – stessi stati, stesso dettaglio per URL, stesso storico.
• Nessun prezzo separato. Stessa tariffa, dallo stesso saldo, da qualunque parte sia stato creato l'ordine.

Un secondo prodotto qui non c'è. Sono le operazioni della dashboard stessa, con sopra una porta leggibile dalle macchine.

03 La tua chiave

La chiave viaggia a ogni chiamata. È tutta qui l'autenticazione:

La chiave identifica l'account e spende il saldo di quell'account. Può essere ruotata o revocata in qualsiasi momento senza toccare la password né le sessioni aperte. Trattala come una credenziale: sta sul tuo server, non in un browser, in un repository pubblico o in un ticket di supporto.

Una richiesta senza una chiave valida viene rifiutata, non riceve spiegazioni e non è distinguibile da una richiesta a un percorso che non esiste. Lo stesso principio lo applichiamo ovunque.

04 Cosa puoi chiamare

Sei operazioni, in corrispondenza uno a uno con quello che fa la dashboard:

• Creare un ordine – mandi una lista di URL e ti torna indietro un ordine in bozza. Non viene addebitato niente e non viene ancora messo niente in coda.
• Avviarlo – la chiamata separata che fa partire la campagna e toglie il credito dal tuo saldo. Sta a parte per un motivo: la bozza è l'unico posto sicuro dove controllare la lista.
• Elencare i tuoi ordini – dal più recente, paginati, con lo stato di ciascuno.
• Leggere un ordine – il suo stato, i suoi contatori e il dettaglio per URL man mano che la campagna procede.
• Controllare il saldo – quello che resta, la stessa cifra che mostra la dashboard.
• Cancellare una bozza – finché è ancora una bozza. Una volta avviata non c'è niente da annullare; vedi la Politica di rimborso.

Nessun webhook in questa prima versione, nessun export di massa, nessun endpoint di reportistica – interroghi un ordine e ne ottieni lo stato. Se il polling non basta per quello che stai costruendo, dillo anche questo.

05 Limiti e regole

Qui non c'è niente di specifico dell'API. È lo stesso servizio con una porta diversa:

• Gli stessi URL minimi e massimi per ordine della dashboard, e tutti gli ordini che vuoi – vedi i prezzi.
• Lo stesso prezzo per URL, prelevato dal tuo saldo nel momento in cui l'ordine parte.
• Limiti di frequenza per chiave, alti quanto basta per un'automazione vera e bassi quanto basta per sopravvivere a un ciclo con un bug dentro.
• La policy di uso accettabile vale esattamente come vale nella dashboard. Una chiave non allarga quello che puoi inviare.

Gli errori tornano in JSON con un codice di stato che significa quello che dice. Un URL rifiutato viene segnalato per singolo URL e non come richiesta fallita – una voce malformata non butta via il resto della lista.

06 Cosa non è

Le pagine API di solito lasciano intendere più di quello che danno, quindi mettiamolo per iscritto:

• Non è un modo per comprare il metodo. Crea ordini. Quello che succede a un URL dopo è la stessa pipeline chiusa descritta nei Termini d'uso, e nessun endpoint la esporrà mai.
• Non è una garanzia di indicizzazione. Un ordine accettato significa che il lavoro è in coda – esattamente quello che significa premere il pulsante nella dashboard, niente di più.
• Non è un'interfaccia per rivenditori. Rivendita o white label richiedono prima un accordo scritto: sales@index-pages.com.
• Non sono gli endpoint che usa la nostra flotta. Quelli esistono, sono interni, non sono rivolti ai clienti e non sono ciò che questa pagina descrive.

07 Chiedi una chiave

Scrivi a support@index-pages.com dall'indirizzo del tuo account, con due righe su cosa vorresti automatizzare. È quella seconda parte a farlo salire in lista, perché costruiamo sull'uso reale e non su un modulo di richiesta funzionalità.

Qui la roadmap la detta la domanda. Non c'è lista d'attesa, non c'è programma beta e non c'è nessun cancello: se ti serve, dillo. Tutto il resto è nella pagina contatti.