Obtener amigos

Detalles sobre el uso del Social Service API para recuperar amistades, solicitudes y amigos en común en la plataforma Decentraland. El API permite a los desarrolladores interactuar con el Social Service para obtener información relacionada con amistades.

REST API

Para recuperar amistades, el Social Service expone un REST API:

• GET /friendships/me - Recupera las amistades del usuario actual. Requiere el token de acceso en el encabezado Authorization.

• GET /friendships/{other-address}/mutuals - Recupera amigos en común con otro usuario. Requiere el token de acceso en el encabezado Authorization.

WebSocket RPC Server

El Social Service WebSocket API proporciona dos tipos de mensajes para recuperar amistades y amigos en común. Primero debes establecer una conexión WebSocket y luego usar esos métodos para transmitir información relacionada con usuarios.

• GetFriends - Recupera los amigos de un usuario. Devuelve un flujo (stream) de respuestas de usuario.

• GetMutualFriends - Recupera amigos en común con otro usuario. Devuelve un flujo (stream) de respuestas de usuario.

Consulta el archivo friendships.proto para más detalles sobre estos tipos de mensajes.

Ejemplos de código en JavaScript

Para interactuar con el Social Service WebSocket API usando JavaScript, puedes usar el cliente RPC proporcionado como se explicó antes. Pero si necesitas implementarlo tú mismo, a continuación hay ejemplos de código que muestran cómo recuperar amigos y amigos en común:

Obtener todos los amigos

import { createRpcClient, createWebSocketsTransport } from '@dcl/rpc/dist/client';
import { FriendshipsServiceDefinition } from './protobuff-types/decentraland/social/friendships/friendships.gen';

const socialClientRpcUrl = 'wss://social.decentraland.org'; // Reemplazar con la URL real
const webSocketsTransport = createWebSocketsTransport(socialClientRpcUrl);
const service = loadService(FriendshipsServiceDefinition, webSocketsTransport);

const response = service.getFriends(Payload.create({ synapseToken }));
for await (const friends of response) {
  processErrors(friends);
  const userList = friends.users?.users ?? [];
  // Procesar la lista de amigos
}

Obtener amigos en común

const response = service.getMutualFriends(
  MutualFriendsPayload.create({
    user: { address }, 
    authToken: { synapseToken }
  })
);
for await (const mutualFriend of response) {
  processErrors(mutualFriend);
  const mutualFriendList = mutualFriend.users?.users ?? [];
  // Procesar la lista de amigos en común
}

Para más ejemplos de código y detalles, visita el repositorio social-rpc-client-js en GitHub