Für Apps

Eine WebSocket API ohne eigenen Server

Eine Echtzeit-API auf gehosteten WebSockets, für Next.js, Laravel, Django und jeden anderen Stack. Ihr Server sendet ein Ereignis in einer kurzen Anfrage, und jede Seite im Raum erhält es sofort. Wir halten die Verbindungen offen, daher müssen Sie keinen WebSocket-Server betreiben, skalieren oder neu starten.

Oder probieren Sie die Live-Demo aus: ein kleiner Shop, in dem eine Bestellung in einem anderen Fenster auf versendet springt, sobald Sie klicken.

Die besten Preise für WebSockets. Ab $11.99 im Monat für 1.000 gleichzeitige Verbindungen, jährlich abgerechnet, oder $14.99 bei monatlicher Abrechnung.

Ihr Server

Next.js auf dem Server und React auf der Seite.

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' } );
}
Ihre App

Hooks und Komponenten für jede React-App, auf jedem der Server oben.

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>;
}
Eine Bestellung wechselt zu Versendet, auf der Shopseite und live auf der Seite des Kunden

Gehostet

Der Teil, den Sie nicht mehr betreiben

Ein WebSocket-Server läuft auf Ihrem Laptop. In der Produktion muss er jede Verbindung stundenlang offen halten, jedes Ereignis zwischen Maschinen teilen und Ihre Deployments überstehen, und ein Serverless-Host kann gar keine Verbindung halten. Hier bleiben die Verbindungen bei uns, und Ihr Server bleibt, wie er ist.

Keine Websocket-Server zu betreiben

Ein eigener Websocket-Server muss jede Verbindung halten, über eine Maschine hinaus wachsen und Deploys überstehen. Die Cloud übernimmt das, mit mehr Servern, wenn Ihr Traffic wächst, und eine Seite wechselt ohne Abbruch auf einen anderen Server.

Jeder Host für Ihren Server

Ihr Server signiert und sendet nur, also läuft er überall, auch in Serverless- und Edge-Funktionen, die selbst keine Verbindung offen halten können.

Ihre Anmeldung bleibt Ihre

Ein Benutzer ist die ID, unter der Ihre App ihn kennt, gelesen auf Ihrem eigenen Server. So funktionieren Ihre Sitzung und Ihre Cookies wie bisher.

Ihr Server entscheidet

An alle senden, sehen, wer online ist, und Ihre Räume verwalten

Ein Raum ist nur ein Name, etwa chat:7, in der Cloud muss nichts angelegt werden. Ihre Datenbank bestimmt, welche Räume es gibt und wer darin ist, eine Regel auf Ihrem Server liest das, und die Cloud hält jede Seite an die Antwort. Hier ist ein Team-Chat, vom Anfang bis zum Ende.

Ihr Server

Next.js auf dem Server und React auf der Seite.

Einen Raum erstellen

Speichern Sie ihn in Ihrer Datenbank und schreiben Sie eine Regel, die ihn liest. Die Regel läuft, wenn jemand beitreten möchte: false hält die Person draußen, true lässt sie hinein, und readOnly lässt sie nur mitlesen, aber nichts senden. Dabei ist db Ihre eigene Datenbank und me die angemeldete Person.

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' ] } );

Der Team-Chat hier ist der Anfang eines Chats: Die Chat-API ergänzt den fertigen Chat, den Verlauf, Lesehäkchen, Dateien und Moderation.

Räume in jedem Stack, mit der ganzen Einrichtung:

Warum WebSockets im eigenen Framework schwierig werden: Next.js, Laravel, Django und Flask, FastAPI.

Betreiben Sie einen eigenen WebSocket-Server? Unser WebSocket-Test prüft ihn von Ihrem Browser aus.

Auf jeder Verbindung

Mehr als ein Socket

Ein Socket überträgt Bytes. Alles, was eine App darum herum baut, von Wiederverbindungen bis zu der Frage, wer online ist, ist schon da.

Die Browser von Ann, Ben und Cara, die jeweils alle drei mit ihren Rollen im Shop zeigen

Bei einer Wiederverbindung geht nichts verloren

Ein Raum kann seine letzten Ereignisse behalten, und eine Seite, die zurückkommt, erhält das Verpasste der Reihe nach, bevor das Nächste folgt.

Wer online ist

Ein Raum kann zeigen, wer gerade darin ist, mit dem, was Sie von jeder Person zeigen möchten. Ein Zähler sagt, wie viele eine Seite gerade ansehen, in jeder Größe, und wer online ist, ist in Ihrer ganzen App bekannt.

Ereignisse von der Seite

Seiten senden an die Räume, in denen sie sind, ohne Anfrage an Ihren Server: Chatnachrichten, Tippen, einen Cursor. Die Regel legt fest, welche Ereignisse gesendet werden dürfen, und ein Webhook gibt Ihrem Server die, die er behalten soll.

An eine Person, überall

Senden Sie an einen Benutzer, und es erreicht jeden Tab und jedes Gerät, das er geöffnet hat, ganz ohne Raum einzurichten.

Verschlüsselt, mit Schlüsseln, die wir nie besitzen

Ereignisse, Präsenz und Verlauf reisen versiegelt mit Schlüsseln, die Ihr Server hält, und Anrufe zwischen zwei Personen sind Ende-zu-Ende-verschlüsselt. Die Cloud überträgt sie, ohne sie lesen zu können.

Eine Verbindung für alle Tabs

Die Tabs eines Browsers teilen sich eine Verbindung, daher zählt eine Person mit drei offenen Tabs nur einmal.

Anwendungsfälle

Was Menschen auf WebSockets bauen

Jeder ist eine ganze App in der Dokumentation, mit ihrem Server in Node.js, PHP und Python.

Live-Updates und Benachrichtigungen

Eine Bestellung, die sich auf ihrer Seite weiterbewegt, ein Dashboard, der Fortschritt eines Jobs und ein Hinweis an einen Benutzer in jedem Tab und jeder App.

Chat

Unterhaltungen zwischen zwei Personen und in Gruppen, mit Tippanzeige, Lesehaken und Reaktionen, gespeichert in Ihrer eigenen Datenbank.

Wer online ist und wer hier ist

Ein Punkt an jedem Avatar, die Personen in einem Raum mit ihren Rollen und wie viele eine Seite ansehen.

Gemeinsam bearbeiten

Wer in einem Dokument ist, ihre Cursor und die Änderungen, binär gesendet und für eine Wiederverbindung aufbewahrt.

Umfragen, Quizze und Fragen

Stimmen und Fragen, die nur Ihren Server erreichen, Ergebnisse an alle und eine Punktzahl für jeden Spieler.

Live-Auktionen

Gebote, die Ihr Server nacheinander entscheidet, der neue Preis an alle und eine Uhr, die bei einem späten Gebot weiterläuft.

Preise

Preise nach Verbindungen, nie nach Nachrichten

Ab $11.99 im Monat für 1.000 gleichzeitige Verbindungen, jährlich abgerechnet, oder $14.99 bei monatlicher Abrechnung.

Der Preis richtet sich nach gleichzeitigen Verbindungen, ab 1.000, monatlich oder jährlich abgerechnet. Nachrichten und Bandbreite werden nie berechnet, und was Ihr Server sendet, verbraucht keine Ihrer Verbindungen.

Derselbe Tarif und dasselbe SDK bringen Videoanrufe und Livestreaming mit, auf derselben Verbindung.

Fragen

Häufige Fragen

Brauche ich einen eigenen WebSocket-Server?

Nein. Browser und Apps halten ihre Verbindungen zu unseren Servern offen, und mit dem Wachstum Ihrer App kommen weitere hinzu. Ihr Server bestimmt nur, wer was betreten darf, und sendet jedes Ereignis in einer kurzen HTTP-Anfrage.

Funktioniert es mit Serverless-Hosting?

Ja. Eine Serverless-Funktion kann keine Verbindung offen halten, und hier muss sie das auch nicht: Sie sendet jedes Ereignis in einer kurzen Anfrage, und die Verbindungen bleiben bei uns. Edge-Funktionen und jeder andere Host funktionieren genauso.

Welche Stacks können die WebSocket API nutzen?

Next.js und Express, Laravel und reines PHP, Django, FastAPI und Flask, Capacitor, iOS und Android, jeweils mit einer Anleitung. React-Native- und Flutter-Apps haben ebenfalls Räume und Präsenz. Ein Server in einer anderen Sprache nutzt die HTTP API.

Schreibe ich den WebSocket-Code selbst?

Nein. Das SDK öffnet die Verbindung, verbindet sich von selbst neu und tritt Ihren Räumen wieder bei, und Sie hören Ereignisse über ihren Namen. In Laravel ist es ein Broadcasting-Treiber, daher bleiben broadcast() und Ihre Channels-Datei, wie sie sind.

Was zählt als Verbindung?

Ein Browser oder ein Gerät, das gerade mit der Cloud verbunden ist. Die Tabs eines Browsers teilen sich eine Verbindung, wenn Ihre App den SDK-Worker ausliefert, und was Ihr Server über die API sendet, zählt nicht.

Was passiert an meiner Verbindungsgrenze?

Bis zu 20 % mehr verbinden sich noch, und der Kontoinhaber erhält bei 80 % und bei 100 % eine E-Mail, rechtzeitig für den Wechsel zu einem größeren Tarif.

Was passiert, wenn eine Seite ihre Verbindung verliert?

Sie verbindet sich von selbst neu. Ein Raum mit Verlauf gibt ihr bis zu 5 Minuten lang der Reihe nach, was sie verpasst hat, und eine Seite, die länger weg war, erfährt das und kann Ihren Server erneut abfragen. Der Verlauf dient nur Wiederverbindungen: Ihre eigene Datenbank bewahrt Ihre Daten auf.

Wer entscheidet, wer einem Raum beitritt?

Ihr Server, mit einer Regel für jede Art von Raum: wer beitritt, was gesendet werden darf und wer nur liest. Die Cloud setzt jede Antwort durch, und Ihr Server kann jederzeit jemanden aus einem Raum entfernen.

Können Sie lesen, was meine App sendet?

Nicht in einem privaten oder Presence-Raum. Seine Ereignisse, sein Verlauf und wer darin ist, reisen versiegelt mit Schlüsseln, die Ihr Server erzeugt, und die Cloud transportiert sie, ohne sie lesen zu können. Ein öffentlicher Raum, dem jeder beitreten darf, läuft unverschlüsselt.

Wo stehen Ihre Server?

Die Echtzeit-Server, die Ihre Ereignisse transportieren, laufen in Deutschland. Die Relays und Medienserver für Anrufe laufen in weiteren Ländern.

Fragen zu Ihrer Integration? Schreiben Sie uns: Wir helfen mit den SDKs, dem Anrufbildschirm und Ihrem Stack.