Visão Geral

Detalhes sobre o uso da Social Service API para recuperar amizades, solicitações e amigos em comum na plataforma Decentraland. A API permite que desenvolvedores interajam com o Social Service para obter informações relacionadas a amizades.

REST API

Para recuperar amizades, o Social Service expõe um REST API:

• GET /friendships/me - Recuperar as amizades do usuário atual. Requer o token de acesso no cabeçalho Authorization.

• GET /friendships/{other-address}/mutuals - Recuperar amigos em comum com outro usuário. Requer o token de acesso no cabeçalho Authorization.

WebSocket RPC Server

A Social Service WebSocket API fornece dois tipos de mensagens para recuperar amizades e amigos em comum. Primeiro você precisa estabelecer uma conexão WebSocket e então usar esses métodos para transmitir informações relacionadas ao usuário.

• GetFriends - Recuperar os amigos de um usuário. Retorna um stream de respostas de usuários.

• GetMutualFriends - Recuperar amigos em comum com outro usuário. Retorna um stream de respostas de usuários.

Consulte o arquivo friendships.proto para mais detalhes sobre esses tipos de mensagem.

Exemplos de Código em JavaScript

Para interagir com a Social Service WebSocket API usando JavaScript, você pode usar o cliente RPC fornecido conforme explicado anteriormente. Mas se precisar implementá-lo você mesmo, abaixo há exemplos de código demonstrando como recuperar amigos e amigos em comum:

Obtendo Todos os 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'; // Substitua pela 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 ?? [];
  // Processar a lista de amigos
}

Obtendo Amigos em Comum

const response = service.getMutualFriends(
  MutualFriendsPayload.create({
    user: { address }, 
    authToken: { synapseToken }
  })
);
for await (const mutualFriend of response) {
  processErrors(mutualFriend);
  const mutualFriendList = mutualFriend.users?.users ?? [];
  // Processar a lista de amigos em comum
}

Para mais exemplos de código e detalhes, visite o repositório social-rpc-client-js no GitHub