Per le app

Un’API WebSocket senza server da gestire

Un’API in tempo reale su WebSocket ospitati, per Next.js, Laravel, Django e qualsiasi altro stack. Il tuo server invia un evento con una breve richiesta e ogni pagina nella stanza lo riceve subito. Le connessioni le teniamo aperte noi, quindi non c’è alcun server WebSocket da gestire, scalare o riavviare.

Oppure prova la demo dal vivo: un piccolo negozio, dove un ordine passa a spedito in un’altra finestra mentre clicchi.

I prezzi migliori per WebSocket. Da $11.99 al mese per 1000 connessioni simultanee, con fatturazione annuale, o $14.99 con fatturazione mensile.

Il tuo server

Next.js sul server e React nella pagina.

app/orders/actions.ts
'use server';

import { realtime } from '@/lib/realtime';

export async function markShipped( id: string ) {
    await saveStatus( id, 'shipped' );
    await realtime.to( `order:${ id }` )
        .emit( 'updated', { status: 'shipped' } );
}
La tua app

Hook e componenti per qualsiasi app React, con uno qualsiasi dei server sopra.

components/Status.jsx
'use client';   // in Next.js

import { useState } from 'react';
import { useRoom } from '@wordplus/realtime/react';

// Inside <RealtimeProvider>, once for the whole app.
export function Status( { id, initial } ) {
    const [ status, setStatus ] = useState( initial );
    useRoom( `order:${ id }`, {
        updated: ( data ) => setStatus( data.status ),
    } );
    return <p>{ status }</p>;
}
Un ordine che passa a Spedito, sulla pagina del negozio e in diretta su quella del cliente

Ospitato

La parte che non gestisci più

Un server WebSocket funziona sul tuo portatile. In produzione deve tenere aperta ogni connessione per ore, condividere ogni evento tra più macchine e sopravvivere ai tuoi deploy, e un host serverless non può tenere una connessione affatto. Qui le connessioni restano da noi e il tuo server resta com’è.

Nessun server websocket da gestire

Il tuo server websocket deve tenere ogni connessione, crescere oltre una macchina e restare attivo durante i deploy. Il cloud lo fa per te, aggiungendo server quando il traffico cresce, e una pagina passa a un altro server senza interruzioni.

Qualsiasi host per il tuo server

Il tuo server si limita a firmare e inviare, quindi gira ovunque, comprese le funzioni serverless ed edge, che da sole non possono tenere aperta una connessione.

Il tuo accesso resta tuo

Un utente è l’id con cui la tua app lo conosce, letto sul tuo server, quindi la tua sessione e i tuoi cookie funzionano come ora.

Decide il tuo server

Invia a chiunque, vedi chi è online e gestisci le tue stanze

Una stanza è solo un nome, come chat:7, senza nulla da creare nel cloud. Il tuo database dice quali stanze esistono e chi c’è dentro, una regola sul tuo server lo legge e il cloud fa rispettare a ogni pagina la risposta. Ecco una chat di team, dall’inizio alla fine.

Il tuo server

Next.js sul server e React nella pagina.

Crea una stanza

Salvala nel tuo database e scrivi una regola che la legge. La regola viene eseguita quando qualcuno chiede di entrare: false lo tiene fuori, true lo fa entrare, e readOnly gli permette di leggere ma non di inviare nulla. Qui db è il tuo database e me è la persona che ha effettuato l’accesso.

app/rooms/actions.ts
// A room is a row of yours. Nothing is created in the cloud.
const room = await db.room.create( { data: { name: 'Team' } } );

await db.member.create( { data: { roomId: room.id, userId: me, role: 'member' } } );

// Its name is yours to choose: row 7 is the room chat:7.
lib/realtime.ts
// Once, for every chat. When someone asks to join chat:7, id is '7'.
realtime.room( 'chat:{id}', async ( user, { id } ) => {
    const room = await db.room.findUnique( { where: { id: Number( id ) } } );
    if ( !room || room.closed ) return false;       // no such room, or closed

    const member = await db.member.findFirst( { where: { roomId: room.id, userId: user } } );
    if ( !member || member.banned ) return false;   // not a member, or banned

    return member.role === 'reader' ? { readOnly: true } : true;
}, { presence: true, emit: [ 'message' ] } );

La chat del team qui è l’inizio di una chat: l’API di chat aggiunge la chat pronta, la cronologia, le spunte di lettura, i file e la moderazione.

Le stanze in ogni stack, con tutta la configurazione:

Perché i WebSocket diventano difficili nel tuo framework: Next.js, Laravel, Django e Flask, FastAPI.

Gestisci un server WebSocket tuo? Il nostro test WebSocket lo verifica dal tuo browser.

Su ogni connessione

Più di un socket

Un socket trasporta byte. Tutto ciò che un’app costruisce attorno, dalle riconnessioni a chi è online, c’è già.

I browser di Ann, Ben e Cara, ognuno con i tre nel negozio ora, con i loro ruoli

Niente si perde in una riconnessione

Una stanza può conservare i suoi ultimi eventi, e una pagina che torna riceve ciò che ha perso, in ordine, prima di ciò che viene dopo.

Chi è online

Una stanza può mostrare chi c’è dentro, con ciò che scegli di mostrare di ogni persona. Un contatore dice quanti stanno guardando una pagina, a qualsiasi scala, e chi è online è noto in tutta la tua app.

Eventi dalla pagina

Le pagine inviano alle stanze in cui si trovano, senza alcuna richiesta al tuo server: messaggi di chat, scrittura in corso, un cursore. La regola dice quali eventi si possono inviare e un webhook consegna al tuo server quelli che deve conservare.

A una persona, ovunque

Invia a un utente e arriva su ogni scheda e dispositivo che ha aperto, senza alcuna stanza da configurare.

Crittografato, con chiavi che non abbiamo mai

Eventi, presenza e cronologia viaggiano sigillati con chiavi che ha il tuo server, e le chiamate tra due persone sono crittografate end-to-end. Il cloud li trasporta senza poterli leggere.

Una connessione per tutte le schede

Le schede di un browser condividono una sola connessione, quindi una persona con tre schede aperte conta una volta.

Casi d’uso

Cosa si costruisce con i WebSocket

Ognuno è un’app completa nella documentazione, con il suo server in Node.js, PHP e Python.

Aggiornamenti dal vivo e notifiche

Un ordine che avanza nella sua pagina, una dashboard, l’avanzamento di un lavoro e un avviso a un utente in ogni scheda e app.

Chat

Conversazioni tra due persone e di gruppo, con indicatore di scrittura, spunte di lettura e reazioni, conservate nel tuo database.

Chi è online e chi è qui

Un puntino su ogni avatar, le persone in una stanza con i loro ruoli e quante guardano una pagina.

Modifiche condivise

Chi è in un documento, i suoi cursori e le modifiche, inviate in binario e conservate per una riconnessione.

Sondaggi, quiz e domande

Voti e domande che arrivano solo al tuo server, risultati inviati a tutti e un punteggio per ogni giocatore.

Aste dal vivo

Offerte che il tuo server decide una alla volta, il nuovo prezzo a tutti e un timer che si sposta con un’offerta tardiva.

Prezzi

Prezzo per connessioni, mai per messaggi

Da $11.99 al mese per 1000 connessioni simultanee, con fatturazione annuale, o $14.99 con fatturazione mensile.

Il prezzo dipende dalle connessioni simultanee, a partire da 1.000, fatturate al mese o all’anno. Messaggi e banda non vengono mai addebitati, e ciò che invia il tuo server non usa nessuna delle tue connessioni.

Lo stesso piano e lo stesso SDK portano videochiamate e streaming dal vivo, sulla stessa connessione.

Domande

Domande frequenti

Mi serve un server WebSocket mio?

No. Browser e app tengono le loro connessioni aperte verso i nostri server, e ne partono altri man mano che la tua app cresce. Il tuo server si limita a dire chi può entrare dove e a inviare ogni evento con una breve richiesta HTTP.

Funziona su hosting serverless?

Sì. Una funzione serverless non può tenere aperta una connessione e qui non deve farlo: invia ogni evento con una breve richiesta e le connessioni restano da noi. Le funzioni edge e qualsiasi altro host funzionano allo stesso modo.

Quali stack possono usare l’API WebSocket?

Next.js ed Express, Laravel e PHP semplice, Django, FastAPI e Flask, Capacitor, iOS e Android, ciascuno con una guida. Anche le app React Native e Flutter hanno stanze e presenza. Un server in qualsiasi altro linguaggio usa l’API HTTP.

Devo scrivere io il codice WebSocket?

No. L’SDK apre la connessione, si ricollega da solo e rientra nelle tue stanze, e tu ascolti gli eventi per nome. In Laravel è un driver di broadcasting, quindi broadcast() e il tuo file dei canali restano come sono.

Che cosa conta come connessione?

Un browser o un dispositivo collegato al cloud in quel momento. Le schede di un browser condividono una connessione quando la tua app serve il worker dell’SDK, e ciò che il tuo server invia tramite l’API non conta.

Cosa succede al raggiungimento del limite di connessioni?

Fino al 20% in più si collega comunque, e il titolare dell’account riceve un’email all’80% e al 100% delle connessioni, in tempo per passare a un piano più grande.

Cosa succede quando una pagina perde la connessione?

Si ricollega da sola. Una stanza che conserva la cronologia le restituisce ciò che ha perso, in ordine, fino a 5 minuti, e una pagina assente più a lungo viene avvisata, così può rileggere dal tuo server. La cronologia serve solo alle riconnessioni: i tuoi dati li conserva il tuo database.

Chi decide chi entra in una stanza?

Il tuo server, con una regola per ogni tipo di stanza: chi entra, cosa può inviare e chi può solo leggere. Il cloud fa rispettare ogni risposta, e il tuo server può togliere qualcuno da una stanza in qualsiasi momento.

Potete leggere ciò che invia la mia app?

Non in una stanza privata o di presenza. I suoi eventi, la sua cronologia e chi c’è dentro viaggiano sigillati con chiavi create dal tuo server, e il cloud li trasporta senza poterli leggere. Una stanza pubblica, a cui chiunque può unirsi, viaggia in chiaro.

Dove sono i vostri server?

I server in tempo reale che trasportano i tuoi eventi si trovano in Germania. I relay e i server multimediali per le chiamate si trovano in più paesi.

Domande sulla tua integrazione? Scrivici: ti aiutiamo con gli SDK, la schermata di chiamata e il tuo stack.