> 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/content/pointers.md).

# 포인터

포인터는 활성 [엔티티를](https://github.com/decentraland/docs/blob/main/contributor/entities.md). 콘텐츠 서버는 이러한 포인터를 해석하여 엔티티의 식별자를 가져올 수 있습니다.

둘 다 기억하세요 [엔티티입니다](https://github.com/decentraland/docs/blob/main/contributor/entities.md) 그리고 그들의 [파일](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md) 는 Decentraland 콘텐츠 시스템에서 변경 불가능하며, 대체 버전이 업로드되면 식별자가 변경됩니다. 반면 포인터는 대체되어도 유지되는 안정적인 참조입니다. 이는 소유자가 대체 버전을 업로드할 때 포인터를 새 엔티티로 자동 리디렉션함으로써 이루어집니다.

여러 포인터가 동일한 [엔티티를](https://github.com/decentraland/docs/blob/main/contributor/entities.md)로 해석될 수 있으며, 이는 종종 [장면](/contributor/contributor-ko/content/entity-types/scenes.md).

아시다시피, 포인터의 가장 일반적인 용도는 활성 버전(즉, 최신 대체 버전)의 ID를 얻는 것입니다. [엔티티를](https://github.com/decentraland/docs/blob/main/contributor/entities.md)를 다운로드하기 위해서입니다.

### 포인터 유형

콘텐츠 서버가 엔티티로 해석할 수 있는 포인터는 4가지 유형이 있으며, 각 유형은 고유한 구문을 가집니다:

* [씬 포인터](/contributor/contributor-ko/content/entity-types/scenes.md#pointers) 는 다음과 같은 파셀 좌표입니다 `"0,0"`.
* [프로필 포인터](/contributor/contributor-ko/content/entity-types/profiles.md#pointers) 는 소유자의 이더리움 주소입니다.
* [웨어러블 포인터](/contributor/contributor-ko/content/entity-types/wearables.md#pointers) 및 [이모트 포인터](/contributor/contributor-ko/content/entity-types/emotes.md#pointers) 는 다음 중 하나입니다 [collection](https://github.com/decentraland/docs/blob/main/contributor/collections.md) 아이템 또는 온체인 외부 URN입니다.
* [스토어 포인터](/contributor/contributor-ko/content/entity-types/stores.md#pointers) 는 소유자의 이더리움 주소가 포함된 오프체인 URN입니다.
* [아웃핏 포인터](/contributor/contributor-ko/content/entity-types/outfits.md#pointers) 는 소유자의 이더리움 주소 뒤에 붙은 `:outfits`.

자세한 내용은 각 섹션에서 확인할 수 있습니다.

### 포인터 해석

콘텐츠 서버에는 포인터를 활성 엔티티의 매니페스트로 해석할 수 있는 엔드포인트가 있으며, 다음에 대한 `GET` 요청을 보냄으로써

```
https://<content-base-url>/entities/<entity-type>?pointer=<pointer>
```

{% hint style="info" %}
역사적 이유로, 이 엔드포인트의 응답은 하나의 요소를 포함하는 배열입니다.
{% endhint %}

Foundation의 콘텐츠 서버를 사용한 유용한 예시 몇 가지:

```bash
# 웨어러블에 대한 온체인 컬렉션 포인터:
curl "https://peer.decentraland.org/content/entities/wearables/?pointer=urn:decentraland:matic:collections-v2:0x30517529cb5c16f686c6d0b48faae5d250d43005:0"

# 기본 자산에 대한 오프체인 컬렉션 포인터:
curl https://peer.decentraland.org/content/entities/wearables/?pointer=urn:decentraland:off-chain:base-avatars:BaseFemale

# 파셀 포인터:
curl https://peer.decentraland.org/content/entities/wearables/?pointer=0,0

# 프로필 포인터:
curl https://peer.decentraland.org/content/entities/profiles/?pointer=0xe2c2b80ca5ad868f4b30fa83cca2bf12cc95b4fe
```

참고로, 이미 엔티티의 ID를 알고 있다면, [매니페스트를 다운로드할 수 있습니다](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md#downloading) 파일을 직접.


---

# 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/content/pointers.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.