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

# Overleaf Import API

> Cho phép các trang web khác mở các đoạn mã LaTeX và dự án trong một bản triển khai Kubernetes.

Import API (`/docs` và các nút "Open in Ayakaleaf", mô-đun `open-in-overleaf`) chạy trong dịch vụ **web** của mọi pod Ayakaleaf Pro và được bật theo mặc định. Các tệp được cung cấp qua URL sẽ được tải xuống thông qua linked-url-proxy trong cùng pod. Cách gọi API được mô tả trong [Overleaf Import API](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/overleaf-import-api.md).

| | |
| - | - |
| Dịch vụ | web (mô-đun `open-in-overleaf`); tải xuống thông qua linked-url-proxy |
| Bên ngoài → Overleaf | trình duyệt gửi `GET` hoặc `POST ${OVERLEAF_SITE_URL}/docs` từ bất kỳ trang web nào |
| Pod → bên ngoài | các lượt tải `snip_uri` và `zip_uri`, bị giới hạn như mô tả trong [URL bên ngoài](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/kubernetes/external-url.md) |
| Trạng thái | yêu cầu của khách chưa đăng nhập, được giữ trong Redis trong 10 phút cho đến khi họ đăng nhập |
| Tác vụ định kỳ | không có |

### Cấu hình

Không cần làm gì để bật tính năng này. Các cài đặt liên quan trong ConfigMap:

| Cài đặt | |
| - | - |
| `OVERLEAF_ALLOW_PUBLIC_ACCESS: "true"` | Khách chưa đăng nhập có thể mở `/devs`, và yêu cầu họ gửi sẽ được giữ cho đến khi họ đăng nhập, xem [Truy cập công khai](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/kubernetes/authentication/public-access.md). |
| `MAX_UPLOAD_SIZE` | Kích thước ZIP lớn nhất mà một yêu cầu có thể mang theo, tính bằng MB (mặc định `50`). Ingress hoặc load balancer của bạn cũng phải chấp nhận phần thân yêu cầu có kích thước đó. |
| `OVERLEAF_LINKED_URL_*` | Các địa chỉ mà `snip_uri` và `zip_uri` có thể trỏ tới, xem [URL bên ngoài](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/kubernetes/external-url.md). |

### Nhiều replica

Không cần thêm gì. Yêu cầu của khách chưa đăng nhập được giữ trong Redis, nên nó sẽ được tiếp tục trên bất kỳ replica nào mà khách truy cập sau khi đăng nhập.

### Đã kiểm thử trên Kubernetes

Trên Kubernetes 1.37 với một replica, các bài kiểm thử end-to-end của chúng tôi cho Import API đều đạt (14 trường hợp): trang `/devs` và dự án mẫu của nó, các đoạn mã, tài liệu hoàn chỉnh, liên kết mã hóa URL và tệp từ data URL được chuyển thành dự án, từ chối các yêu cầu không thể trở thành dự án, từ chối tải xuống từ các địa chỉ nội bộ, các bài gửi và liên kết của khách chưa đăng nhập được giữ qua bước đăng nhập, và, với `OVERLEAF_ALLOW_PUBLIC_ACCESS`, `/devs` cho khách chưa đăng nhập và một đoạn mã đã gửi được tiếp tục một lần sau khi đăng nhập; trường hợp cuối cùng cũng đạt trên ba replica phía sau HAProxy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.