For the complete documentation index, see llms.txt. This page is also available as Markdown.

Visão geral

Detalhes sobre como usar a API do Social Service para recuperar amizades, pedidos e amigos em comum na plataforma Decentraland. A API permite que os developers interajam com o Social Service para recuperar informações relacionadas com amizades.

REST API

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

  • GET /friendships/me - Recupera as amizades do utilizador atual. Requer o token de acesso no cabeçalho Authorization.

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

Servidor RPC WebSocket

A API WebSocket do Social Service disponibiliza dois tipos de mensagem para recuperar amizades e amigos em comum. Primeiro, é necessário estabelecer uma ligação WebSocket e depois usar esses métodos para transmitir informações relacionadas com o utilizador.

  • Obter amigos - Recupera os amigos de um utilizador. Devolve um stream de respostas do utilizador.

  • Obter amigos em comum - Recupera amigos em comum com outro utilizador. Devolve um stream de respostas do utilizador.

Consulte o ficheiro friendships.proto para mais detalhes sobre estes tipos de mensagem.

Exemplos de código JavaScript

Para interagir com a API WebSocket do Social Service usando JavaScript, pode usar o cliente RPC fornecido, como explicado anteriormente. Mas, se precisar de o implementar por si, abaixo estão exemplos de código que demonstram como recuperar amigos e amigos em comum:

Obter 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 pelo 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
}

A obter amigos em comum

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

Atualizado