> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Esquema de URL

> Use o esquema de URL do Craft para automatizar fluxos de trabalho e integrar com outros apps.

O esquema de URL permite que usuários e desenvolvedores de outros apps enviem comandos para o Craft. Esta página explica como ele funciona e quais são as capacidades atuais.

<Info title="Observação">
  Planejamos adicionar mais funcionalidades às existentes no futuro.
</Info>

## Comandos Disponíveis

A seguir estão os comandos que o Craft entende:

* Abrir um Documento
* Criar um Documento
* Adicionar a um Documento existente
* Iniciar busca em um Espaço
* Acessar Notas Diárias

## Abrir Página

**Entradas:**

* **blockId** – você pode acessá‑lo clicando em Copy Deeplink em um Documento; o link contém um parâmetro blockId
* **spaceId** – normalmente é o id do seu usuário (GUID aleatório). Se for um Espaço compartilhado, você precisa obtê‑lo clicando em Copy Deeplink

**Exemplo:**

```
craftdocs://open?spaceId=<spaceId>&blockId=<blockId>
```

<Warning title="Aviso">
  Não funciona quando você não é membro do Espaço.
</Warning>

## Abrir Espaço

**Entradas:**

* **spaceId** – você pode obter isso a partir de um deeplink simples, ao clicar em Copy Deeplink
* **(opcional) tab** – `calendar` **ou** `search` **ou** `documents`

**Exemplo:**

```
craftdocs://openspace?spaceId=<spaceId>&tab=<tab>
```

<Warning title="Aviso">
  Não funciona quando você não é membro do Espaço.
</Warning>

## Criar Novo Documento Vazio

**Entrada:**

Use esta URL para criar um novo Documento vazio no Espaço que você tem aberto atualmente:

```
craftdocs://createnewdocument
```

## Criar Documento

**Entradas:**

* **spaceId** – você pode obter isso a partir de um deeplink simples, ao clicar em Copy Deeplink
* **content** – markdown codificado em porcentagem (imagens não suportadas ainda)
* **title** – título em texto simples codificado em porcentagem
* **folderId** – o parâmetro é obrigatório, mas pode ficar vazio

**Exemplo:**

```
craftdocs://createdocument?spaceId=<spaceId>&title=<title>&content=<content>&folderId=<folderId>
```

## Adicionar ao Documento

**Entradas:**

* **spaceId** – você pode obter isso a partir de um deeplink simples, ao clicar em Copy Deeplink
* **index** – índice do novo Bloco (0 para inserir no início, um número grande para acrescentar no final - maior que a quantidade de Blocos no seu Documento)
* **parentBlockId** – blockId do Documento
* **content** – string codificada em porcentagem

**Exemplo:**

```
craftdocs://createblock?parentBlockId=<parentBlockId>&spaceId=<spaceId>&content=<content>&index=<index>
```

## Buscar no Espaço

Inicia uma busca em um Espaço e preenche o campo de busca com o conteúdo da consulta.

**Entradas:**

* **spaceId** – você pode obter isso a partir de um deeplink simples, ao clicar em Copy Deeplink
* **query** – certifique‑se de que está codificado em porcentagem

**Exemplo:**

```
craftdocs://opensearch?spaceId=<spaceId>&query=<query>
```

## Acesso às Notas Diárias

* **Ontem** – `craftdocs://openByQuery?query=yesterday&spaceId=<spaceId>`
* **Hoje** – `craftdocs://openByQuery?query=today&spaceId=<spaceId>`
* **Amanhã** – `craftdocs://openByQuery?query=tomorrow&spaceId=<spaceId>`

## Artigos relacionados

<CardGroup cols={2}>
  <Card title="Craft API" href="/pt-BR/integrate/api">
    Documentação completa da API REST para integrar com o Craft
  </Card>

  <Card title="iOS Shortcuts" href="/pt-BR/integrate/apple-shortcuts">
    Automatize o Craft no iOS com Shortcuts
  </Card>

  <Card title="Deeplinks (Guia do Usuário)" href="/pt-BR/organize-and-find/linking/deeplinks">
    Aprenda a usar deeplinks no seu fluxo de trabalho
  </Card>
</CardGroup>