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

### Funktionen "Overleaf Import API"

Fra og med Ayakaleaf Pro v6.3 kan du oprette links, der importerer en LaTeX-fil eller et zippet projekt fra en URL og åbner det i din egen Ayakaleaf-instans, på samme måde som Overleafs ["Open in Overleaf"-API](https://cn.overleaf.com/devs).

Denne funktion er aktiveret som standard; du skal blot besøge `your.overleaf.com/devs` for at se en detaljeret side med instruktioner.

<Info>
  Siden `/devs` kræver login, medmindre `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`, se [Signed-out visitors](/da/on-premises/configuration/overleaf-toolkit/overleaf-import-api#signed-out-visitors "mention").
</Info>

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/Wx0mJ_Lfqd9J3VFX/images/on-premises/image-51.png?fit=max&auto=format&n=Wx0mJ_Lfqd9J3VFX&q=85&s=5ba20ae774c684ce71df33d454bda528" alt="" width="2102" height="600" data-path="images/on-premises/image-51.png" />
</Frame>

Hvis du for eksempel hoster en LaTeX-fil på `https://example.com/main.tex` eller et komplet projekt på `https://example.com/project.zip`, kan du oprette et link, der importerer det til din egen Ayakaleaf Pro-instans og åbner det nye projekt:

<Tabs>
  <Tab title="LaTeX-fil">
    ```text wrap theme={null}
    https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fmain.tex
    ```
  </Tab>

  <Tab title="ZIP-projekt">
    ```text wrap theme={null}
    https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fproject.zip
    ```
  </Tab>
</Tabs>

Erstat `ayakaleaf.example.com` med din instans' domæne.

#### Åbn et LaTeX-projekt i Ayakaleaf Pro

Fra og med Ayakaleaf Pro v6.3 kan du oprette et link, der importerer en LaTeX-fil eller et zippet projekt til din egen Ayakaleaf Pro-instans. Når nogen åbner linket, opretter Ayakaleaf Pro et nyt projekt ud fra den angivne fil og åbner det i editoren.

Send linket til din instans' `/docs`-endpoint:

| Parameter | Beskrivelse | Eksempel |
| - | - | - |
| `snip_uri` | URL til en LaTeX-fil, der skal importeres. En enkelt ZIP-fil accepteres også, men brug `zip_uri` til projekter. | `https://example.com/main.tex` |
| `zip_uri` | URL til et zippet LaTeX-projekt, der skal importeres. | `https://example.com/project.zip` |
| `snip_uri[]` | Importér flere filer ved at gentage denne parameter. | `snip_uri[]=.../main.tex&snip_uri[]=.../refs.bib` |
| `snip_name[]` | Angiv filnavnet for hver `snip_uri[]` i samme rækkefølge. | `snip_name[]=main.tex` |
| `engine` | Angiv compileren: `latex_dvipdf`, `pdflatex`, `xelatex` eller `lualatex`. | `engine=xelatex` |
| `main_document` | Angiv den primære `.tex`-fil i det importerede projekt. | `main_document=main.tex` |
| `name` | Angiv navnet på det nye projekt. `project_name` accepteres også. | `name=My%20Project` |

Hvis dine filer for eksempel hostes på `example.com`, importerer disse links dem til en Ayakaleaf Pro-instans, der hostes på `ayakaleaf.example.com`.

#### Importér et projekt med Base64

Du kan indlejre en LaTeX-fil eller et zippet projekt direkte i et "Open in Ayakaleaf"-link som en Base64-data-URL. Det giver dig mulighed for at oprette et importlink uden at hoste filen på en separat URL.

| Indhold | Parameter | Data-URL-format |
| - | - | - |
| LaTeX-fil | `snip_uri` | `data:application/x-tex;base64,<base64-encoded-tex>` |
| Zippet projekt | `zip_uri` | `data:application/zip;base64,<base64-encoded-zip>` |

For at importere et ZIP-projekt skal du i stedet Base64-kode ZIP-filen og sende den via `zip_uri`. Brug `encodeURIComponent` på hele data-URL'en, når du konstruerer et af disse links. Til store projekter bør du bruge en hostet ZIP-URL, fordi browserens og serverens grænser for URL-længde kan gøre Base64-links upraktiske.

#### Tilføj en "Open in Ayakaleaf"-knap

Du kan bruge en HTML-formular til at importere en fil, når en besøgende klikker på en knap. Send formularen til din instans' `/docs`-endpoint med `method="post"`.

For en hostet LaTeX-fil:

```text theme={null}
<form action="https://ayakaleaf.example.com/docs" method="post" target="_blank">
  <input type="hidden" name="snip_uri" value="https://example.com/main.tex">
  <input type="hidden" name="engine" value="xelatex">
  <button type="submit">Open in Ayakaleaf</button>
</form>
```

For at importere et zippet projekt skal du erstatte `snip_uri` med `zip_uri` og lade den pege på ZIP-filen. Du kan også sende LaTeX-kildekode direkte med `snip` for rå tekst eller `encoded_snip` for URL-kodet tekst.

Erstat `ayakaleaf.example.com` med din instans' domæne. Hvis din instans har blokering af cross-origin-anmodninger aktiveret, skal du tilføje det websted, der hoster formularen, til `ALLOWED_ORIGINS`.

#### Besøgende, der ikke er logget ind

Det nye projekt oprettes på den besøgendes konto, så vedkommende skal logge ind. Hvordan en besøgende, der ikke er logget ind, kommer dertil, afhænger af, hvordan importen sendes:

* **Links** (`GET /docs?...`) fungerer på alle instanser: Den besøgende sendes til login-siden, og importen fortsætter efter login.
* **Formularer** (`POST /docs`) kræver `OVERLEAF_ALLOW_PUBLIC_ACCESS=true` for besøgende, der ikke er logget ind. Indsendelsen gemmes så i 10 minutter, indtil den besøgende har logget ind, og bruges én gang.

<Warning>
  Som standard (`OVERLEAF_ALLOW_PUBLIC_ACCESS` ikke sat) sendes en formular, der indsendes af en besøgende, som ikke er logget ind, til login-siden, før Ayakaleaf Pro læser den, og indsendelsen går tabt: Efter login ser den besøgende *no snippet, snip\_uri or zip\_uri provided*. Brug links, bed de besøgende om at logge ind først, eller aktivér offentlig adgang, se [Page Access](/da/on-premises/configuration/overleaf-toolkit/public-access#page-access "mention").
</Warning>

<Accordion title="Hvilke ZIP- eller TeX-ressourcer kan jeg importere?">
  Ayakaleaf Pro bruger mikrotjenesten `linked-url-proxy` (der primært bruges til [external-url.md](/da/on-premises/configuration/overleaf-toolkit/external-url "mention")) til at hente eksterne ressourcer. Generelt kan enhver offentligt tilgængelig ZIP- eller TeX-ressource på internettet importeres. Ressourcer, der hostes på private eller interne netværk, blokeres af sikkerhedshensyn.

  Fra og med den genudgivne Ayakaleaf Pro 6.3.0 (3. oktober 2026) kan du konfigurere en HTTP(S)-proxy til at hente eksterne ZIP- og TeX-ressourcer med `OVERLEAF_LINKED_URL_OUTBOUND_PROXY`. Se [Outbound Proxy](/da/on-premises/configuration/overleaf-toolkit/external-url#outbound-proxy "mention") for at få oplysninger om konfiguration og begrænsninger af netværksadgang.
</Accordion>


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