SviluppatoriPubblica su qualsiasi cosa tua.
Una destinazione personalizzata è una rete che Ocoya non ha bisogno di conoscere. Dagli un URL e riceverà il tuo contenuto finito in JSON, proprio come un post va su Instagram, solo che dall’altra parte ci sei tu.
La destinazione per tutto il resto.
Quasi tutto ciò che si pubblica va su una rete con un logo. Questa è per il resto.
Il tuo blog
Gli articoli scritti in Ocoya arrivano in qualunque CMS usi già: Ghost, Strapi, Sanity, qualcosa che hai costruito tu.
Una rete che non supportiamo
Ricevi il post e inoltralo tu. Dal tuo codice puoi raggiungere qualsiasi cosa abbia un’API.
Un tuo passaggio di approvazione
Indirizza i contenuti pubblicati in una coda di revisione, un canale Slack o un foglio di calcolo prima che vadano altrove.
I tuoi archivi
Conserva una copia di tutto ciò che pubblichi nel tuo data warehouse, senza interrogare un’API per ottenerla.
Un URL, un nome e di solito un header.
Non c’è nessun giro di OAuth, perché entrambi i capi sono tuoi. Incolla l’indirizzo, aggiungi l’header con cui si autentica il tuo endpoint e comparirà nell’editor accanto ai tuoi profili social.
- Qualsiasi URL che accetta una POST e risponde 2xx
- Header per qualunque metodo di autenticazione usi il tuo endpoint
- Compare nell’editor come qualsiasi altro profilo
Collega una destinazione personalizzata
Nome
URL del webhook
Opzioni avanzate
Quattro passi, e nessuno richiede una settimana di sviluppo.
Prepara dove riceverlo
Qualsiasi URL che accetta una POST con corpo JSON e risponde 2xx. Deve essere raggiungibile da internet: Ocoya lo chiama dai nostri server, non dal tuo browser.
Aggiungi la destinazione
Integrazioni → Personalizzata. Dagli un nome che riconoscerai nell’editor e incolla l’URL.
Aggiungi un header, se serve
In Opzioni avanzate, aggiungi l’header con cui si autentica il tuo endpoint, di solito Authorization o X-API-Key. Viene salvato cifrato e non viene mai rimandato al browser.
Pubblicaci come su una rete
Compare nell’editor accanto ai tuoi profili social. Programma un post, o indirizzaci una campagna del blog, e riceverà tutto ciò che l’editor ha salvato.
Una POST, con solo ciò che serve a un blog.
Il corpo è JSON: il titolo, la didascalia esattamente come scritta (in Markdown se è un articolo), un’immagine di copertina e, quando ci sono, slug, estratto, tag e campi SEO dell’articolo. Nient’altro, quindi non c’è niente da ignorare.
- Content-Type: application/json, più gli header che hai aggiunto
- caption è il corpo come scritto; title e image sono separati
- post.id resta lo stesso tra i tentativi, così puoi aggiornare invece di duplicare
Rispondi con un 2xx e Ocoya segna il post come pubblicato. Qualsiasi altra risposta ti viene mostrata con il corpo restituito dal tuo endpoint.
Ogni campo, con il suo tipo
Slug, estratto, campi SEO, tag e tempo di lettura di un articolo: cosa sono, e quali mancano in un post social.
È il tuo endpoint, e lo chiamiamo con cura.
Una destinazione è un indirizzo a cui ci colleghiamo dalla nostra rete, quindi viene trattata come tale.
Gli indirizzi privati e interni vengono rifiutati, e la connessione resta vincolata all’indirizzo risolto.
Un redirect viene seguito solo dopo che il nuovo indirizzo ha superato lo stesso controllo.
I tuoi header vengono salvati cifrati e non vengono mai rimandati al browser.
Qualunque cosa risponda il tuo endpoint compare nel registro attività, corpo compreso.
Pubblicalo dove deve stare.
Collega una destinazione in un minuto e indirizzaci la tua prossima campagna.