> 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-zh/nei-rong/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-zh/nei-rong/shi-ti-lei-xing/scenes.md).

正如你可能已经猜到的，指针最常见的用途是获取某个 [实体](https://github.com/decentraland/docs/blob/main/contributor/entities.md)，以便下载它。

### 指针类型

内容服务器可以解析为实体的指针共有 4 种类型，每种都有各自的语法：

* [场景指针](/contributor/contributor-zh/nei-rong/shi-ti-lei-xing/scenes.md#pointers) 是地块坐标，例如 `"0,0"`.
* [资料指针](/contributor/contributor-zh/nei-rong/shi-ti-lei-xing/profiles.md#pointers) 是所有者的以太坊地址。
* [可穿戴指针](/contributor/contributor-zh/nei-rong/shi-ti-lei-xing/wearables.md#pointers) 和 [表情动作指针](/contributor/contributor-zh/nei-rong/shi-ti-lei-xing/emotes.md#pointers) 可以是 [collection](https://github.com/decentraland/docs/blob/main/contributor/collections.md) 物品或链下 URN。
* [商店指针](/contributor/contributor-zh/nei-rong/shi-ti-lei-xing/stores.md#pointers) 是带有所有者以太坊地址的链下 URN。
* [装扮指针](/contributor/contributor-zh/nei-rong/shi-ti-lei-xing/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-zh/nei-rong/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.