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