> 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/put-friends.md).

# 친구 저장하기

이벤트와 사용자와 관련된 작업을 수행하기 위해 Social Service API와 상호작용합니다. 이러한 작업에는 새 친구 요청 생성, 들어오는 요청 수락 또는 거절, 그리고 친구 관계 삭제가 포함됩니다. Social Service를 통해 사용자는 플랫폼 내에서 관계와 상호작용을 관리할 수 있습니다.

### 친구 관계와 작업

Social Service 내의 친구 관계는 사용자 간의 양방향 관계입니다. 친구 요청 보내기, 요청 수락 또는 거절, 요청 취소, 친구 관계 제거와 같은 작업을 통해 이러한 관계를 업데이트할 수 있습니다. 이러한 각 작업은 사용자 간 관계에 특정한 영향을 미칩니다.

### 친구 관계 업데이트 구현

이러한 친구 관계 관련 작업을 수행하려면, `UpdateFriendshipEvent` 메시지를 사용해야 합니다. 이 메시지를 사용하면 요청, 수락, 거절, 취소, 제거와 같은 친구 관계 관련 다양한 작업을 실행할 수 있습니다.

각 작업에 필요한 정확한 페이로드 구조와 필수 매개변수는 `UpdateFriendshipEvent` 메시지에 지정되어 있습니다.

**사용 예시**

다음은 `UpdateFriendshipEvent` 친구 요청을 보내기 위한 예시입니다:

```proto
message UpdateFriendshipEvent {
  string userAddress = 1;
  string targetUserAddress = 2;
  FriendshipAction action = 3;
}
```

이 예시에서, `userAddress` 는 보낸 사람의 주소를 나타내며, `targetUserAddress` 는 받는 사람의 주소를 나타내며, `action` 는 수행할 작업 유형(요청, 수락, 거절, 취소 또는 제거)을 나타냅니다.

#### 친구 요청 보내기

사용자는 누구나 다른 사용자에게 친구 요청을 보낼 수 있습니다. 그러나 친구 관계를 성립하려면 수신자 사용자가 요청을 수락해야 합니다.

```javascript
requestFriendship: async (address: string, message?: string) => {
  const response = await service.updateFriendshipEvent({
    event: { request: { user: { address }, message } },
    authToken: { synapseToken }
  })
  processErrors(response)
  return response.event
}
```

#### 요청 수락 또는 거절

사용자가 친구 요청을 받으면, 이를 수락하거나 거절할 수 있습니다. 요청을 수락하면 두 사용자 간에 상호 친구 관계가 성립됩니다. 요청을 거절하면 친구 관계 성립이 거부됩니다.

```javascript
acceptFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      event: { accept: { user: { address } } },
      authToken: { synapseToken }
    })
  )
  processErrors(response)
  return response.event
}
```

```javascript
rejectFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      authToken: { synapseToken },
      event: { reject: { user: { address } } }
    })
  )
  processErrors(response)
  return response.event
}
```

#### 친구 요청 취소

사용자가 수락되기 전에 보낸 친구 요청을 철회하기로 결정하면, 요청을 취소할 수 있습니다. 이렇게 하면 수신자가 요청을 보거나 응답하는 것을 방지할 수 있습니다.

```javascript
cancelFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      event: { cancel: { user: { address } } },
      authToken: { synapseToken }
    })
  )
  processErrors(response)
  return response.event
}
```

#### 친구 관계 제거

상호 친구 관계에 있는 어느 쪽 사용자든 친구 관계를 제거할 수 있습니다. 친구 관계가 제거되면 양쪽 사용자의 기록에서 삭제되어 상호 관계가 종료됩니다.

```javascript
removeFriend: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      authToken: { synapseToken },
      event: { delete: { user: { address } } }
    })
  )
  processErrors(response)
  return response.event
}
```


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/contributor/contributor-ko/social-service/put-friends.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.