Desarrolladores
Referencia técnica para integrar y extender Salas Shipo.
Conexión WebSocket
Para conectarse a una sala, establecé una conexión WebSocket segura usando el ID numérico de la sala:
wss://salas.shipo.site/?roomId={numero}
Reemplazá {numero} por el ID de la sala a la que querés conectarte. Una vez establecida la conexión, el socket queda asignado a esa sala y puede comenzar el intercambio de mensajes según el protocolo.
Nota: La conexión debe ser WebSocket Secure (wss://).
Conexiones ws:// no están disponibles en producción.
Lista de salas
Podés obtener la lista de salas disponibles en formato JSON desde el siguiente endpoint:
GET https://salas.shipo.site/salas.json
La respuesta es un array de objetos con las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | number | ID numérico único de la sala. Usar en la URL de conexión WebSocket. |
| name | string | Nombre visible de la sala. |
| topic | string | Tema o descripción actual de la sala. |
Ejemplo de respuesta:
[
{ "id": 1001, "name": "General", "topic": "Bienvenidos a Salas Shipo" },
{ "id": 1002, "name": "Tecnología", "topic": "Hablemos de tech" }
]
Ejemplo de uso en JavaScript:
const res = await fetch('https://salas.shipo.site/salas.json');
const rooms = await res.json();
for (const room of rooms) {
console.log(room.id, room.name, room.topic);
// Conectar a una sala:
// const ws = new WebSocket(`wss://salas.shipo.site/?roomId=${room.id}`);
}