> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/local-rest-api.md).

# Sử dụng API REST cục bộ

Bật API REST cục bộ của Incogniton trong Cài đặt → Tự động hóa, chọn cổng của nó, và điều khiển các hồ sơ của bạn từ các script trên máy tính của bạn.

Mở **Cài đặt** trong menu bên trái và nhấp vào tab **Tự động hóa**. Bật **Bật API tự động hóa** và nhấp vào **Lưu**. Các script của bạn sau đó có thể truy cập Incogniton tại `http://127.0.0.1:35000`.

API REST cục bộ cho phép các script và công cụ trên máy tính của bạn liệt kê, tạo, chỉnh sửa, khởi chạy và dừng các hồ sơ trình duyệt của bạn. Incogniton CLI và các SDK JavaScript và Python đều sử dụng API này.

{% hint style="info" %}
API tự động hóa là một tính năng trả phí. Trong gói không có tự động hóa, các cài đặt trên tab này bị khóa và tab hiển thị **Tự động hóa không được bao gồm trong gói của bạn.** với một liên kết **Nâng cấp**.
{% endhint %}

### Bật hoặc tắt API

{% stepper %}
{% step %}

#### Mở tab Tự động hóa

Nhấp vào **Cài đặt** trong menu bên trái, sau đó nhấp vào tab **Tự động hóa**.
{% endstep %}

{% step %}

#### Bật API

Bật **Bật API tự động hóa**. Các trường cổng và các nút CLI chỉ có thể được sử dụng khi công tắc này được bật.
{% endstep %}

{% step %}

#### Lưu

Nhấp vào **Lưu** trong thanh ở dưới cùng của màn hình. Việc bật hoặc tắt API được áp dụng ngay khi bạn lưu.
{% endstep %}
{% endstepper %}

Ứng dụng Incogniton phải được mở và đăng nhập để API hoạt động. Khi bạn đóng ứng dụng, API cũng dừng.

### Thay đổi cổng API

API lắng nghe trên cổng **35000** theo mặc định. Để sử dụng cổng khác, nhập nó vào trường **API port** và nhấp vào **Lưu**. Một số cổng mới được sử dụng lần tiếp theo bạn khởi động Incogniton.

Nếu một chương trình khác đã sử dụng cổng, Incogniton sẽ hiển thị thông báo rằng cổng đã được sử dụng và không khởi động API. Bạn có thể khắc phục điều này theo hai cách:

* Nhập một cổng trống vào **API port**.
* Bật **Sử dụng cổng trống tiếp theo nếu cổng được cấu hình đã được sử dụng**. Incogniton sau đó chọn cổng trống tiếp theo. Trong khi API chạy, tab hiển thị cổng mà nó thực sự sử dụng: "API REST hiện đang chạy trên cổng …".

Trường **Selenium port** (mặc định 4444) đặt cổng của lưới Selenium mà Incogniton chạy bên cạnh API cho các script Selenium.

### Ai có thể truy cập API

API chỉ lắng nghe trên `127.0.0.1` (localhost). Các máy tính khác trên mạng của bạn không thể kết nối với nó. Các trang web bạn truy cập cũng không thể gửi yêu cầu đến nó thông qua trình duyệt của bạn. Các script, CLI và SDK chạy trên cùng máy tính hoạt động bình thường.

API hoạt động với tài khoản đã đăng nhập vào ứng dụng. Nó thấy các hồ sơ giống như bạn thấy trong ứng dụng.

### Những gì bạn có thể làm với API

Với API, bạn có thể liệt kê, tạo, chỉnh sửa, sao chép và xóa hồ sơ, khởi chạy và dừng chúng, đọc và thay đổi cookie của chúng, và khởi chạy một hồ sơ cho Puppeteer, Playwright hoặc Selenium. Để gọi một hồ sơ, bạn cần ID của nó: mở rộng hồ sơ trong danh sách hồ sơ và nhấp vào **Sao chép** bên cạnh **Profile ID**.

Các điểm cuối, tham số của chúng và các yêu cầu ví dụ có trong tài liệu dành cho nhà phát triển:

* [Bắt đầu nhanh](https://api-docs.incogniton.com/getting-started/quickstart): cuộc gọi đầu tiên của bạn trong vài phút.
* [Tham khảo API](https://api-docs.incogniton.com/apis): mọi điểm cuối. Bạn cũng có thể mở nó từ liên kết **Tài liệu API** trên tab Tự động hóa.
* [Ví dụ tự động hóa](https://api-docs.incogniton.com/how-to-guides/automation-examples): các script Puppeteer, Playwright và Selenium sẵn sàng chạy.

### Sử dụng CLI hoặc SDK thay thế

Bạn không cần phải tự viết các cuộc gọi HTTP:

* **Incogniton CLI**: chạy các hành động tương tự như các lệnh trong terminal. Nhấp vào **Tải xuống CLI** trên tab Tự động hóa; trong khi nó được cài đặt, nó tự cập nhật khi ứng dụng khởi động. Xem [tài liệu CLI](https://api-docs.incogniton.com/cli).
* [**JavaScript và Python SDK**](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/javascript-and-python-sdk.md): gọi API từ mã.
* [**Kết nối khách hàng AI (MCP)**](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/connect-ai-clients-mcp.md): cho phép một khách hàng AI như Claude hoặc Cursor quản lý các hồ sơ của bạn.
