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

### Funksjonen "Overleaf Import API"

Fra og med Ayakaleaf Pro v6.3 kan du lage lenker som importerer en LaTeX-fil eller et zippet prosjekt fra en URL og åpner det i din egen Ayakaleaf-instans, på samme måte som Overleafs [«Open in Overleaf»-API](https://cn.overleaf.com/devs).

Denne funksjonen er aktivert som standard; du trenger bare å besøke `your.overleaf.com/devs` for å se en detaljert side med instruksjoner.

<Info>
  Siden `/devs` krever innlogging med mindre `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`, se [Utloggede besøkende](/no/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 har en LaTeX-fil på `https://example.com/main.tex` eller et komplett prosjekt på `https://example.com/project.zip`, kan du lage en lenke som importerer den til din egen Ayakaleaf Pro-instans og åpner det nye prosjektet:

<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-prosjekt">
    ```text wrap theme={null}
    https://ayakaleaf.example.com/docs?snip_uri=https%3A%2F%2Fexample.com%2Fproject.zip
    ```
  </Tab>
</Tabs>

Erstatt `ayakaleaf.example.com` med domenet til instansen din.

#### Åpne et LaTeX-prosjekt i Ayakaleaf Pro

Fra og med Ayakaleaf Pro v6.3 kan du lage en lenke som importerer en LaTeX-fil eller et zippet prosjekt til din egen Ayakaleaf Pro-instans. Når noen åpner lenken, oppretter Ayakaleaf Pro et nytt prosjekt fra den oppgitte filen og åpner det i editoren.

Send lenken til endepunktet `/docs` på instansen din:

| Parameter | Beskrivelse | Eksempel |
| - | - | - |
| `snip_uri` | URL til en LaTeX-fil som skal importeres. En enkelt ZIP-fil godtas også, men bruk `zip_uri` for prosjekter. | `https://example.com/main.tex` |
| `zip_uri` | URL til et zippet LaTeX-prosjekt som skal importeres. | `https://example.com/project.zip` |
| `snip_uri[]` | Importer flere filer ved å gjenta denne parameteren. | `snip_uri[]=.../main.tex&snip_uri[]=.../refs.bib` |
| `snip_name[]` | Angi filnavnet for hver `snip_uri[]`, i samme rekkefølge. | `snip_name[]=main.tex` |
| `engine` | Angi kompilatoren: `latex_dvipdf`, `pdflatex`, `xelatex` eller `lualatex`. | `engine=xelatex` |
| `main_document` | Angi hoved-`.tex`-filen i det importerte prosjektet. | `main_document=main.tex` |
| `name` | Angi navnet på det nye prosjektet. `project_name` godtas også. | `name=My%20Project` |

Hvis filene dine for eksempel ligger på `example.com`, importerer disse lenkene dem til en Ayakaleaf Pro-instans som kjører på `ayakaleaf.example.com` .

#### Importere et prosjekt med Base64

Du kan bygge inn en LaTeX-fil eller et zippet prosjekt direkte i en «Open in Ayakaleaf»-lenke som en Base64-data-URL. Dette lar deg lage en importlenke uten å måtte legge filen på en egen URL.

| Innhold | Parameter | Format for data-URL |
| - | - | - |
| LaTeX-fil | `snip_uri` | `data:application/x-tex;base64,<base64-encoded-tex>` |
| Zippet prosjekt | `zip_uri` | `data:application/zip;base64,<base64-encoded-zip>` |

For å importere et ZIP-prosjekt Base64-koder du ZIP-filen og sender den via `zip_uri` i stedet. Bruk `encodeURIComponent` på hele data-URL-en når du bygger en av lenkene. For store prosjekter bør du bruke en ZIP-URL som ligger på en server, fordi begrensninger på URL-lengde i nettlesere og servere kan gjøre Base64-lenker upraktiske.

#### Legge til en «Open in Ayakaleaf»-knapp

Du kan bruke et HTML-skjema for å importere en fil når en besøkende klikker på en knapp. Send skjemaet til endepunktet `/docs` på instansen din med `method="post"`.

For en LaTeX-fil som ligger på en server:

```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 å importere et zippet prosjekt erstatter du `snip_uri` med `zip_uri` og lar den peke til ZIP-filen. Du kan også sende LaTeX-kildekode direkte med `snip` for råtekst eller `encoded_snip` for URL-kodet tekst.

Erstatt `ayakaleaf.example.com` med domenet til instansen din. Hvis instansen din blokkerer forespørsler på tvers av opprinnelser (cross-origin), legger du til nettstedet som har skjemaet i `ALLOWED_ORIGINS`.

#### Utloggede besøkende

Det nye prosjektet opprettes i den besøkendes konto, så vedkommende må logge inn. Hvordan en utlogget besøkende kommer dit, avhenger av hvordan importen sendes:

* **Lenker** (`GET /docs?...`) fungerer på alle instanser: den besøkende sendes til innloggingssiden, og importen fortsetter etter innlogging.
* **Skjemaer** (`POST /docs`) krever `OVERLEAF_ALLOW_PUBLIC_ACCESS=true` for utloggede besøkende. Innsendingen beholdes da i 10 minutter til den besøkende har logget inn, og brukes én gang.

<Warning>
  Som standard (`OVERLEAF_ALLOW_PUBLIC_ACCESS` ikke satt) sendes et skjema fra en utlogget besøkende til innloggingssiden før Ayakaleaf Pro leser det, og innsendingen går tapt: etter innlogging ser den besøkende *no snippet, snip\_uri or zip\_uri provided*. Bruk lenker, be besøkende logge inn først, eller aktiver offentlig tilgang, se [Sidetilgang](/no/on-premises/configuration/overleaf-toolkit/public-access#page-access "mention").
</Warning>

<Accordion title="Hvilke ZIP- eller TeX-ressurser kan jeg importere?">
  Ayakaleaf Pro bruker mikrotjenesten `linked-url-proxy` (hovedsakelig brukt for [external-url.md](/no/on-premises/configuration/overleaf-toolkit/external-url "mention")) til å hente eksterne ressurser. Generelt kan alle offentlig tilgjengelige ZIP- eller TeX-ressurser på Internett importeres. Ressurser som ligger i private eller interne nettverk, blokkeres av sikkerhetshensyn.

  Fra og med den gjenutgitte Ayakaleaf Pro 6.3.0 (3. oktober 2026) kan du konfigurere en HTTP(S)-proxy for henting av eksterne ZIP- og TeX-ressurser med `OVERLEAF_LINKED_URL_OUTBOUND_PROXY`. Se [Utgående proxy](/no/on-premises/configuration/overleaf-toolkit/external-url#outbound-proxy "mention") for konfigurasjon og begrensninger på nettverkstilgang.
</Accordion>


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