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

# Pointers

Pointers são strings únicas e insensíveis a maiúsculas/minúsculas que referenciam um ativo [entity](https://github.com/decentraland/docs/blob/main/contributor/entities.md). Os content servers podem resolver esses pointers para obter o identificador da entidade.

Lembre-se de que tanto [entities](https://github.com/decentraland/docs/blob/main/contributor/entities.md) quanto seus [files](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md) são imutáveis no sistema de content do Decentraland, e seus identificadores mudam quando versões de substituição são carregadas. Pointers, por outro lado, são referências estáveis que persistem através de substituições. Isso é conseguido redirecionando automaticamente o pointer para uma nova entidade quando o proprietário carrega uma substituição.

Múltiplos pointers podem resolver para o mesmo [entity](https://github.com/decentraland/docs/blob/main/contributor/entities.md), como frequentemente ocorre com [cenas](/contributor/contributor-pt/conteudo/tipos-de-entidade/scenes.md).

Como você pode perceber, o uso mais comum de pointers é obter o ID da versão ativa (ou seja, a última substituição) de uma [entity](https://github.com/decentraland/docs/blob/main/contributor/entities.md), a fim de baixá-la.

### Tipos de Pointers

Existem 4 tipos de pointers que os content servers podem resolver para entidades, cada um com sua própria sintaxe:

* [Scene pointers](/contributor/contributor-pt/conteudo/tipos-de-entidade/scenes.md#pointers) são coordenadas de parcelas, como `"0,0"`.
* [Profile pointers](/contributor/contributor-pt/conteudo/tipos-de-entidade/profiles.md#pointers) são o endereço Ethereum do proprietário.
* [Wearable pointers](/contributor/contributor-pt/conteudo/tipos-de-entidade/wearables.md#pointers) e [emote pointers](/contributor/contributor-pt/conteudo/tipos-de-entidade/emotes.md#pointers) são ou [collection](https://github.com/decentraland/docs/blob/main/contributor/collections.md) item URNs ou URNs off-chain.
* [Store pointers](/contributor/contributor-pt/conteudo/tipos-de-entidade/stores.md#pointers) são URNs off-chain com o endereço Ethereum do proprietário.
* [Outfits pointers](/contributor/contributor-pt/conteudo/tipos-de-entidade/outfits.md#pointers) são o endereço Ethereum do proprietário suplementado por `:outfits`.

Você pode encontrar mais detalhes em suas seções específicas.

### Resolvendo Pointers

Os content servers têm um endpoint que pode resolver pointers no manifesto da sua entidade ativa, fazendo uma `GET` requisição para:

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

{% hint style="info" %}
Por razões históricas, a resposta deste endpoint é um array contendo um elemento.
{% endhint %}

Alguns exemplos úteis, usando o content server da Foundation:

```bash
# Um pointer on-chain de coleção para um wearable:
curl "https://peer.decentraland.org/content/entities/wearables/?pointer=urn:decentraland:matic:collections-v2:0x30517529cb5c16f686c6d0b48faae5d250d43005:0"

# Um pointer off-chain de coleção para um asset padrão:
curl https://peer.decentraland.org/content/entities/wearables/?pointer=urn:decentraland:off-chain:base-avatars:BaseFemale

# Um pointer de parcela:
curl https://peer.decentraland.org/content/entities/wearables/?pointer=0,0

# Um pointer de perfil:
curl https://peer.decentraland.org/content/entities/profiles/?pointer=0xe2c2b80ca5ad868f4b30fa83cca2bf12cc95b4fe
```

Observe que, se você já conhece o ID da entidade, você pode [baixar o manifesto](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md#downloading) diretamente.


---

# 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:

```
GET https://docs.decentraland.org/contributor/contributor-pt/conteudo/pointers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.