Integrazioni · Webhook
Il vostro sistema, collegato con un solo indirizzo
Ogni articolo approvato arriva come JSON firmato a un indirizzo di vostra scelta. I vostri sviluppatori, o uno strumento di automazione, proseguono da lì.
Cosa riceve il vostro endpoint
POST https://your-system.example/hooks/newsX-Mediastilo-Signature: sha256=9f2c…e41a{ "event": "publish", "action": "created", "previousExternalId": null, "title": "Ministry puts €12 million into home insulation…", "content": "The ministry approved…", "status": "publish", "scheduledAt": null, "featuredImage": { "url": "…", "credit": "…" }, "images": [ … ]}
In ogni consegna
Cosa riceve il vostro endpoint
- Titolo e testoIl testo in Markdown, esattamente come l’ha approvato il vostro caporedattore.
- Stato e orarioSe pubblicare subito, e quando, se l’articolo è programmato.
- ImmaginiL’immagine in evidenza e ogni immagine dell’articolo, in ordine, ciascuna con testo alternativo, didascalia, crediti e licenza. I link restano validi sette giorni.
- Creato o aggiornatoUn articolo ripubblicato lo dichiara e porta l’id che il vostro sistema gli ha dato l’ultima volta.
- Una firmaOgni richiesta è firmata con HMAC-SHA256 usando un segreto noto solo a voi e a Mediastilo.
- Il vostro id di ritornoRispondete con id e URL del vostro record, e Mediastilo li conserva per il prossimo aggiornamento.
Collegato in pochi minuti
- 01
Dateci un indirizzo
Qualsiasi endpoint HTTPS che accetti un POST.
- 02
Inviamo un test
Mediastilo invia un ping, e il collegamento viene salvato solo quando il vostro endpoint lo accetta.
- 03
Verificate la firma
Confrontate l’header X-Mediastilo-Signature con il vostro HMAC del testo, e sapete che la richiesta viene da noi.
Cosa collegano i team in questo modo
Un CMS interno
I gruppi con un proprio sistema editoriale ricevono gli articoli direttamente.
Strumenti di newsletter
Mandate gli articoli approvati nel prossimo numero.
Piattaforme di automazione
Make, n8n o Zapier, per raggiungere qualsiasi altra cosa usiate.
Domande sul webhook
E se il nostro endpoint non risponde?
La pubblicazione viene segnalata come non riuscita in Mediastilo, con il motivo, così il caporedattore può riprovare quando il sistema torna disponibile.
Perché il testo è in Markdown?
È la forma più portabile: qualsiasi sistema può trasformarlo nel proprio HTML o nei propri blocchi, senza perdere nulla per strada.
Possiamo ricevere HTML invece?
Non oggi. La maggior parte dei sistemi converte il Markdown con una riga di codice; diteci se il vostro non può.
Pubblicate per primi.
Configurate le vostre fonti oggi stesso, oppure parlateci di un desk della vostra dimensione.
Preferite guardare prima? La vetrina dal vivo è a un clic. Guarda dal vivo