API Web di Owncast.

Le API web sono il modo in cui il codice in esecuzione fuori da Owncast comunica con il tuo server tramite HTTP. Si dividono in due parti:

• Webhooks notificano la tua applicazione quando succede qualcosa sullo stream, come l'arrivo di un messaggio in chat o lo stream che va in diretta. Owncast invia un POST HTTP a un endpoint che ospiti.
• API permettono alla tua applicazione di inviare azioni verso Owncast, come pubblicare un messaggio in chat o aggiornare il titolo dello stream. Le richieste sono autenticate con un token di accesso.

Per ricevere webhook, crea un endpoint su un qualsiasi server web, in qualsiasi linguaggio, che accetti un POST HTTP. Ogni payload di evento contiene un campo type che nomina l'evento e un oggetto eventData con i suoi dettagli.

Esempio

Riferimento API

Esplora ogni endpoint nella API rilasciata o nella API in sviluppo.

Ambiente di sviluppo

Ospita il tuo codice ovunque e scrivilo in qualsiasi linguaggio. Deve essere raggiungibile dal tuo server Owncast per ricevere webhook, e in grado di raggiungere il tuo server per chiamare le API. Durante lo sviluppo in locale, uno strumento di tunneling come ngrok o Cloudflare Tunnel fornisce alla tua macchina un URL pubblico temporaneo così Owncast può inviare webhook a questo URL. Quando sei pronto, sposta il codice su qualsiasi server o piattaforma di hosting che preferisci.

Esegui invece il tuo codice all'interno di Owncast

Se preferisci che il tuo codice venga eseguito all'interno del server invece di chiamarlo via HTTP, i plugin sono l'altro modo per sviluppare. Consulta modi per estendere Owncast per vedere come i due approcci si confrontano.