Webhook

Un webhook invia una richiesta POST a un tuo indirizzo quando succede qualcosa ai pacchetti che scegli: per avviare un deploy, aprire una pull request o pubblicare un messaggio in un canale di chat.

Prima di iniziare

Ti serve un indirizzo https:// che accetti richieste POST, oppure l’URL del webhook in entrata di un canale Slack o Discord. I webhook di un team si trovano nell’organizzazione: la tua organizzazione → Webhook, con le stesse pagine.

Aggiungi un webhook

1. Apri Impostazioni → Webhook e poi Aggiungi un webhook.
2. Inserisci l’URL del payload (1).
3. Scegli il Formato (2): JSON (firmato) per il tuo server, Slack o Discord per un canale.
4. Spunta gli Eventi (3): Nuove versioni, Avvisi di sicurezza, Pacchetti ritirati.
5. Scegli i Pacchetti (4): i pacchetti che segui, i pacchetti che elenchi per nome Composer, oppure tutti i pacchetti (una consegna per ogni build del repository).
6. Seleziona Aggiungi webhook (5).

Per i webhook JSON, la pagina mostra poi una sola volta il segreto di firma: copialo sul tuo server.

Verifica una consegna JSON

Ogni consegna JSON contiene l’intestazione X-MeteorGPL-Signature: sha256=<HMAC-SHA256 of the body with your secret>. Calcola lo stesso HMAC sul corpo grezzo e confrontali prima di fidarti del payload. Il corpo indica l’evento e, per ogni pacchetto, il nome Composer, il titolo, il tipo, le nuove versioni, un link e il comando di installazione.

I tuoi webhook

Ogni webhook mostra l’indirizzo e il formato con il suo stato: Attivo, In pausa o Disattivato dopo errori ripetuti (1); poi gli eventi e i pacchetti (2).

• Invia un test (3) invia subito una consegna ping.
• Metti in pausa e Attiva sospendono e riprendono le consegne; Rimuovi elimina il webhook.
• Consegne recenti (4) mostra ogni consegna con il suo esito, lo stato HTTP con cui ha risposto il tuo server e il numero di tentativi; Ripeti la consegna ne ripete una.

Una consegna non riuscita viene ritentata più tardi: sei tentativi in tutto, distribuiti su circa 15 ore. Dopo 20 errori consecutivi il webhook viene disattivato e vieni avvisato; correggi l’endpoint e seleziona Attiva.