Le stesse operazioni
Quello che fate a schermo, lo fate con una chiamata: siti, contenuti, immagini, temi, menu, reindirizzamenti, pubblicazione, Search Console. La documentazione elenca ogni operazione, una per una.
Sviluppatori
Joornal si pilota tramite API
Tutto ciò che fa il back-office si fa anche tramite API: creare un sito, importare contenuti, pubblicare, leggere i dati di Search Console. Con i vostri strumenti, nelle vostre catene, con gli stessi permessi dei vostri utenti.
La stessa cosa dell’interfaccia, senza l’interfaccia
Questa API non è un sottoinsieme concesso controvoglia. È la stessa applicazione, vista dall’altro capo.
Gli stessi permessi
Un token raggiunge solo l’ambito di chi lo detiene: il suo cliente, i suoi progetti, i suoi siti. Una risorsa al di fuori risponde 403. Non esiste un «account API» separato, con regole proprie da tenere aggiornate.
Nessuna sessione, nessun cookie
Un’intestazione X-API-TOKEN per ogni chiamata, verificata ogni volta. Niente da aprire, niente da rinnovare, niente da conservare nel browser.
Errori che si assomigliano
Un contratto d’errore unico su tutta l’API: un codice macchina stabile, un messaggio leggibile e il dettaglio campo per campo quando una convalida fallisce. Scrivete la gestione degli errori una volta sola.
Che cosa pilotate
Gli usi che ricorrono più spesso presso agenzie e gruppi multimarca.
Alimentare dai vostri sistemi
Importazione di contenuti in blocco, idempotente: ripetere la stessa chiamata non crea duplicati, e decidete voi se lascia stare l’esistente o se lo aggiorna. Potete retrodatare, programmare un’uscita, collegare categorie e firmatari, e caricare le immagini nello stesso movimento.
Riprendere un sito esistente
Migrazione da WordPress o da un export, poi la messa in linea: tema, dominio, reindirizzamenti, sitemap. Il parco si crea e si configura per chiamata, non per ticket.
Pubblicare al momento giusto
Avviare una pubblicazione, riprogrammare una coda di articoli, seguirne l’avanzamento. Le operazioni lunghe restituiscono un identificativo di attività da interrogare fino alla fine.
Riportare indietro i dati
Prestazioni di Search Console per articolo, stato di indicizzazione URL per URL, statistiche di passaggio dei robot, contatti raccolti dal modulo. Per alimentare i vostri cruscotti invece di ricopiarli.
Su che cosa potete contare
Un’API che si collega è un’API di cui si conoscono le regole in anticipo. Le nostre sono scritte nella documentazione, non in un contratto da richiedere.
Un anno dopo la deprecazione
Un campo o un’operazione destinati a sparire vengono prima marcati nella specifica, con il loro sostituto e la data della marcatura. Restano serviti per almeno un anno a partire da quella data. Avete sempre un anno intero per spostarvi.
Una specifica che non mente
La specifica OpenAPI è pubblica, e la nostra integrazione continua rifiuta ogni modifica dell’API che non sia accompagnata dall’aggiornamento della documentazione. La documentazione non può restare indietro in silenzio: mostra la data della sua ultima revisione.
Limiti annunciati
Ogni risposta porta il margine che vi resta. Non dovete scoprire un limite sbattendoci contro, e potete rallentare prima che vi fermi.
Un filtro sconosciuto viene rifiutato
Un parametro scritto male o dismesso produce un errore, mai un risultato che sembra soltanto corretto. È il tipo di dettaglio che si nota solo il giorno in cui è già costato una settimana.
Riprendete il controllo della vostra visibilità
Prenotate una demo su misura e scoprite come costruire una testata strutturata, efficace e guidata dai dati.