> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/contributor/contributor-ko/social-service/ws.md). # 웹소켓 소셜 서비스는 Decentraland 내의 친구 관계를 관리하는 서버입니다. Matrix 플랫폼을 활용하여, 요청, 수락, 거절, 취소 및 삭제와 같은 친구 관계 업데이트를 처리하는 권위 있는 소스 역할을 합니다. ### 사용 사례 소셜 서비스는 친구 관계와 관련된 다음 사용 사례를 처리합니다: * 친구 요청하기 * 친구 요청 수락하기 * 친구 요청 거절하기 * 친구 요청 취소하기 * 친구 삭제하기 * 내 모든 친구 목록 보기 * 나와 다른 사용자 사이의 공통 친구 목록 보기 ### 배경 소셜 서비스 도입 전에는 친구 데이터가 Matrix에서 직접 저장되고 조회되었습니다. 이로 인해 친구 관계 워크플로와 정보의 신뢰성에 여러 문제가 있었습니다. 또한 새로운 기능을 구현하는 것도 어려웠습니다. Matrix는 주로 채팅 기능을 처리하므로, 소셜 서비스는 Matrix와 상호작용하기 전에 필요한 비즈니스 로직을 적용하는 프록시 역할을 합니다. ### 아키텍처 #### 버전 기록 1. [첫 번째 버전](https://adr.decentraland.org/adr/ADR-113): 처음에는 소셜 서비스가 모든 친구와 상호 연결 목록을 조회하는 GET 엔드포인트만 제공하는 REST API였습니다. 업데이트나 요청 전송과 관련된 기능은 없었습니다. 2. [두 번째 버전](https://adr.decentraland.org/adr/ADR-189): 이 버전에서는 친구 관계 흐름에 대한 업데이트가 도입되었습니다. 이러한 변경 사항을 처리하기 위해 WebSocket RPC 서버가 구현되었습니다. 이 서버는 필수 메시지를 처리하며, 클라이언트와의 연결을 열린 상태로 유지해 적시에 업데이트를 제공합니다. WebSocket 연결은 또한 다음과 같은 기능을 가능하게 합니다 [접속 상태 추적](https://github.com/decentraland/adr/blob/420e63926d20166ae832e3de62dd9e3f2370cd49/content/ADR-246-poc-presence.md) 소셜 서비스 내에서. #### URL **.zone 도메인** 테스트 및 테스트넷 사용 시의 개발 환경 서버. * [Matrix로 로그인](https://social.decentraland.zone) * [REST API](https://social.decentraland.zone) * [WebSocket API](https://rpc-social.decentraland.zone) **.org 도메인** 프로덕션 환경 서버 및 메인넷 사용 시. * [Matrix로 로그인](https://social.decentraland.org) * [REST API](https://social.decentraland.org) * [WebSocket API](https://rpc-social.decentraland.org) ### JavaScript 클라이언트를 사용하려면 JavaScript 클라이언트를 사용하려면 다음을 참조하세요 ### 참조 클라이언트 구현 * [Matrix 클라이언트](https://github.com/decentraland/matrix-client) * [JS 클라이언트](https://github.com/decentraland/social-rpc-client-js) * [Rust 참조 클라이언트](https://github.com/decentraland/social-client) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.decentraland.org/contributor/contributor-ko/social-service/ws.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.