Pour les applications

Une API WebSocket sans serveur à gérer

Une API temps réel sur des WebSockets hébergés, pour Next.js, Laravel, Django et toute autre stack. Votre serveur envoie un événement en une courte requête, et chaque page de la salle le reçoit aussitôt. Nous gardons les connexions ouvertes : aucun serveur WebSocket à exploiter, à dimensionner ou à redémarrer.

Ou essayez la démo en direct : une petite boutique, où une commande passe à expédiée dans une autre fenêtre au fil de vos clics.

Les meilleurs tarifs pour les WebSockets. À partir de $11.99 par mois pour 1 000 connexions simultanées, facturé à l’année, ou $14.99 facturé au mois.

Votre serveur

Next.js sur le serveur et React sur la page.

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

Des hooks et des composants pour toute app React, avec n'importe lequel des serveurs ci-dessus.

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>;
}
Une commande qui passe à Expédiée, sur la page de la boutique et en direct sur celle du client

Hébergé

La partie que vous n’exploitez plus

Un serveur WebSocket fonctionne sur votre ordinateur portable. En production, il doit garder chaque connexion ouverte pendant des heures, partager chaque événement entre des machines et survivre à vos déploiements, et un hébergeur serverless ne peut pas garder de connexion du tout. Ici, les connexions restent chez nous, et votre serveur reste tel quel.

Aucun serveur websocket à maintenir

Votre propre serveur websocket doit garder chaque connexion, dépasser une seule machine et tenir pendant les déploiements. Le cloud s’en charge, en ajoutant des serveurs quand votre trafic augmente, et une page passe sur un autre serveur sans coupure.

Tout hébergeur pour votre serveur

Votre serveur ne fait que signer et envoyer : il fonctionne partout, y compris sur les fonctions serverless et edge, qui ne peuvent pas garder une connexion ouverte.

Votre authentification reste la vôtre

Un utilisateur est identifié par l’id que votre application lui connaît, lu sur votre propre serveur : votre session et vos cookies fonctionnent comme aujourd’hui.

Votre serveur décide

Envoyez à qui vous voulez, voyez qui est en ligne et gérez vos salles

Une salle n’est qu’un nom, comme chat:7, sans rien à créer dans le cloud. Votre base de données dit quelles salles existent et qui s’y trouve, une règle sur votre serveur la lit, et le cloud impose sa réponse à chaque page. Voici un chat d’équipe, du début à la fin.

Votre serveur

Next.js sur le serveur et React sur la page.

Créer une salle

Enregistrez-la dans votre base de données et écrivez une règle qui la lit. La règle s’exécute quand quelqu’un demande à rejoindre : false le refuse, true le laisse entrer, et readOnly lui permet de lire sans rien envoyer. Ici, db est votre propre base de données et me est la personne connectée.

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

Le chat d’équipe ici en est le début : l’API de chat ajoute le chat prêt à l’emploi, l’historique, les accusés de lecture, les fichiers et la modération.

Les salles dans chaque stack, avec toute la mise en place :

Pourquoi les WebSockets deviennent difficiles dans votre propre framework : Next.js, Laravel, Django et Flask, FastAPI.

Vous exploitez votre propre serveur WebSocket ? Notre test WebSocket le vérifie depuis votre navigateur.

Sur chaque connexion

Plus qu’un simple socket

Un socket transporte des octets. Tout ce qu’une application construit autour, des reconnexions à la présence en ligne, est déjà là.

Les navigateurs d’Ann, Ben et Cara, chacun listant les trois dans la boutique, avec leurs rôles

Rien de perdu à la reconnexion

Une salle peut garder ses derniers événements, et une page qui revient reçoit ce qu’elle a manqué, dans l’ordre, avant la suite.

Qui est en ligne

Un salon peut afficher qui s’y trouve, avec ce que vous choisissez de montrer de chacun. Un compteur indique combien de personnes regardent une page, à n’importe quelle échelle, et qui est en ligne est connu dans toute votre application.

Des événements depuis la page

Les pages envoient aux salles où elles se trouvent, sans requête vers votre serveur : messages de chat, saisie en cours, curseur. La règle dit quels événements peuvent être envoyés, et un webhook transmet à votre serveur ceux qu’il doit conserver.

À une personne, partout

Envoyez à un utilisateur, et le message arrive dans chaque onglet et chaque appareil ouverts, sans salle à configurer.

Chiffré, avec des clés que nous ne détenons jamais

Les événements, la présence et l’historique voyagent scellés avec des clés que détient votre serveur, et les appels entre deux personnes sont chiffrés de bout en bout. Le cloud les transporte sans pouvoir les lire.

Une connexion pour tous les onglets

Les onglets d’un navigateur partagent une seule connexion : une personne avec trois onglets ouverts compte pour une.

Cas d’usage

Ce que l’on construit avec les WebSockets

Chacun est une application complète dans la documentation, avec son serveur en Node.js, PHP et Python.

Mises à jour en direct et notifications

Une commande qui avance sur sa page, un tableau de bord, la progression d’une tâche, et une notification à un utilisateur dans tous ses onglets et applications.

Chat

Des conversations à deux et en groupe, avec saisie en cours, accusés de lecture et réactions, conservées dans votre propre base de données.

Qui est en ligne et qui est là

Un point sur chaque avatar, les personnes d’une salle avec leurs rôles, et combien regardent une page.

Édition à plusieurs

Qui est dans un document, leurs curseurs et les modifications, envoyés en binaire et gardés pour une reconnexion.

Sondages, quiz et questions

Des votes et des questions qui n’arrivent qu’à votre serveur, des résultats envoyés à tous, et un score pour chaque joueur.

Enchères en direct

Des offres que votre serveur tranche une à une, le nouveau prix envoyé à tous, et un compte à rebours qui se prolonge en cas d’offre tardive.

Tarifs

Un prix selon les connexions, jamais selon les messages

À partir de $11.99 par mois pour 1 000 connexions simultanées, facturé à l’année, ou $14.99 facturé au mois.

Tarif selon les connexions simultanées, à partir de 1 000, facturé au mois ou à l’année. Les messages et la bande passante ne sont jamais facturés, et ce que votre serveur envoie n’utilise aucune de vos connexions.

La même formule et le même SDK apportent les appels vidéo et la diffusion en direct, sur la même connexion.

Questions

Questions fréquentes

Ai-je besoin de mon propre serveur WebSocket ?

Non. Les navigateurs et les applications gardent leurs connexions ouvertes vers nos serveurs, et d’autres démarrent à mesure que votre application grandit. Votre serveur indique seulement qui peut rejoindre quoi, et envoie chaque événement en une courte requête HTTP.

Cela fonctionne-t-il sur un hébergement serverless ?

Oui. Une fonction serverless ne peut pas garder une connexion ouverte, et ici elle n’en a pas besoin : elle envoie chaque événement en une courte requête, et les connexions restent chez nous. Les fonctions edge et tout autre hébergeur fonctionnent de la même façon.

Quelles stacks peuvent utiliser l’API WebSocket ?

Next.js et Express, Laravel et PHP simple, Django, FastAPI et Flask, Capacitor, iOS et Android, chacun avec un guide. Les applications React Native et Flutter disposent aussi des salles et de la présence. Un serveur dans tout autre langage utilise l’API HTTP.

Dois-je écrire moi-même le code WebSocket ?

Non. Le SDK ouvre la connexion, se reconnecte de lui-même et rejoint de nouveau vos salles, et vous écoutez les événements par leur nom. Dans Laravel, c’est un pilote de diffusion : broadcast() et votre fichier de canaux restent tels quels.

Qu’est-ce qui compte comme une connexion ?

Un navigateur ou un appareil connecté au cloud à ce moment-là. Les onglets d’un navigateur partagent une connexion quand votre application sert le worker du SDK, et ce que votre serveur envoie par l’API ne compte pas.

Que se passe-t-il à ma limite de connexions ?

Jusqu’à 20 % de connexions en plus peuvent encore se connecter, et le propriétaire du compte reçoit un e-mail à 80 % et à 100 %, à temps pour passer à une formule plus large.

Que se passe-t-il quand une page perd sa connexion ?

Elle se reconnecte d’elle-même. Une salle qui garde un historique lui rend ce qu’elle a manqué, dans l’ordre, jusqu’à 5 minutes, et une page absente plus longtemps en est informée, pour relire votre serveur. L’historique ne sert qu’aux reconnexions : c’est votre propre base de données qui garde vos données.

Qui décide de qui rejoint une salle ?

Votre serveur, avec une règle pour chaque type de salle : qui rejoint, ce qu’il peut envoyer, et qui ne fait que lire. Le cloud applique chaque réponse, et votre serveur peut sortir quelqu’un d’une salle à tout moment.

Pouvez-vous lire ce que mon application envoie ?

Pas dans une salle privée ou de présence. Ses événements, son historique et la liste de ses membres voyagent scellés avec des clés que fabrique votre serveur, et le cloud les transporte sans pouvoir les lire. Une salle publique, que tout le monde peut rejoindre, circule en clair.

Où sont vos serveurs ?

Les serveurs temps réel qui transportent vos événements se trouvent en Allemagne. Les relais et serveurs médias pour les appels se trouvent dans davantage de pays.

Des questions sur votre intégration ? Écrivez-nous : nous vous aidons avec les SDK, l’écran d’appel et votre stack.