> 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/tree/main/contributor/entities.md)。内容服务器可以解析这些指针以获取实体的标识符。

请记住，这两者 [实体](https://github.com/decentraland/docs/tree/main/contributor/entities.md) 及其 [文件](https://github.com/decentraland/docs/tree/main/contributor/filesystem.md) 在 Decentraland 内容系统中都是不可变的，在上传替换版本时它们的标识符会改变。另一方面，指针是稳定的引用，会在替换之间保持不变。当所有者上传替换版本时，系统会自动将指针重定向到新的实体，从而实现这一点。

多个指针可以解析到同一个 [实体](https://github.com/decentraland/docs/tree/main/contributor/entities.md)，这在 [场景](/contributor/contributor-zh/nei-rong/shi-ti-lei-xing/scenes.md).

你可能已经看出来了，指针最常见的用途是获取某个 [实体](https://github.com/decentraland/docs/tree/main/contributor/entities.md)的活动版本（即最新替换版本）的 ID，以便下载它。

### 指针类型

内容服务器可以解析为实体的指针有 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/tree/main/contributor/collections.md) 物品 URN 或链下 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/tree/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 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-zh/nei-rong/pointers.md?ask=<question>&goal=<user_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.