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

# Giao thức URL

> Sử dụng giao thức URL của Craft để tự động hóa quy trình và tích hợp với các ứng dụng khác.

Giao thức URL cho phép người dùng và nhà phát triển của các ứng dụng khác gửi lệnh tới Craft. Trang này giải thích cách hoạt động và những khả năng hiện tại.

<Info title="Lưu ý">
  Chúng tôi dự định bổ sung thêm chức năng vào những khả năng hiện có trong tương lai.
</Info>

## Các lệnh có sẵn

Các lệnh mà Craft hỗ trợ:

* Mở một Tài liệu
* Tạo Tài liệu mới
* Thêm vào Tài liệu hiện có
* Bắt đầu tìm kiếm trong Không gian
* Truy cập Ghi chú hàng ngày

## Mở Trang

**Đầu vào:**

* **blockId** - bạn có thể truy cập nó nếu bạn Nhấp vào Copy Deeplink trong một Tài liệu; liên kết có tham số blockId
* **spaceId** - thường là id người dùng của bạn (một GUID ngẫu nhiên); nếu đó là một Không gian chia sẻ, bạn cần lấy nó bằng cách Nhấp vào Copy Deeplink

**Ví dụ:**

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

<Warning title="Cảnh báo">
  Tính năng này không hoạt động nếu bạn không phải là thành viên của Không gian.
</Warning>

## Mở Không gian

**Đầu vào:**

* **spaceId** - bạn có thể lấy này từ một deeplink đơn giản khi Nhấp vào Copy Deeplink
* **(tùy chọn) tab** - `calendar` **hoặc** `search` **hoặc** `documents`

**Ví dụ:**

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

<Warning title="Cảnh báo">
  Tính năng này không hoạt động nếu bạn không phải là thành viên của Không gian.
</Warning>

## Tạo Tài liệu trống mới

**Đầu vào:**

Chỉ cần sử dụng URL này để tạo một Tài liệu trống mới trong Không gian bạn đang mở:

```
craftdocs://createnewdocument
```

## Tạo Tài liệu

**Đầu vào:**

* **spaceId** - bạn có thể lấy này từ một deeplink đơn giản khi Nhấp vào Copy Deeplink
* **content** - Markdown được mã hóa theo phần trăm (hiện chưa hỗ trợ hình ảnh)
* **title** - tiêu đề văn bản thuần được mã hóa theo phần trăm
* **folderId** - tham số bắt buộc, nhưng có thể để trống

**Ví dụ:**

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

## Thêm vào Tài liệu

**Đầu vào:**

* **spaceId** - bạn có thể lấy này từ một deeplink đơn giản khi Nhấp vào Copy Deeplink
* **index** - chỉ số của Khối mới (0 để chèn lên đầu, số lớn để thêm vào cuối - nhiều Khối hơn số Khối hiện có trong Tài liệu của bạn)
* **parentBlockId** - blockId của Tài liệu
* **content** - chuỗi đã được mã hóa theo phần trăm

**Ví dụ:**

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

## Tìm kiếm trong Không gian

Bắt đầu tìm kiếm trong một Không gian nhất định và tự động điền nội dung truy vấn vào trường tìm kiếm.

**Đầu vào:**

* **spaceId** - bạn có thể lấy này từ một deeplink đơn giản khi Nhấp vào Copy Deeplink
* **query** - đảm bảo đã mã hóa theo phần trăm

**Ví dụ:**

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

## Truy cập Ghi chú hàng ngày

* **Hôm qua** – `craftdocs://openByQuery?query=yesterday&spaceId=<spaceId>`
* **Hôm nay** – `craftdocs://openByQuery?query=today&spaceId=<spaceId>`
* **Ngày mai** – `craftdocs://openByQuery?query=tomorrow&spaceId=<spaceId>`

## Bài viết liên quan

<CardGroup cols={2}>
  <Card title="Craft API" href="/vi/integrate/api">
    Tài liệu đầy đủ về REST API để tích hợp với Craft
  </Card>

  <Card title="iOS Shortcuts" href="/vi/integrate/apple-shortcuts">
    Tự động hóa Craft trên iOS bằng Shortcuts
  </Card>

  <Card title="Deeplinks (User Guide)" href="/vi/organize-and-find/linking/deeplinks">
    Tìm hiểu cách sử dụng deeplinks trong quy trình làm việc của bạn
  </Card>
</CardGroup>