> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

Obtenez une licence, lancez FineParser avec Docker et convertissez votre premier document en DocLang en moins de cinq minutes.

<h2 id="before-you-begin">
  Avant de commencer
</h2>

* [Docker](https://docs.docker.com/get-docker/) installé et en cours d'exécution
* Un fichier PDF ou image à analyser
* Un fichier de licence FineParser. Souscrivez une formule sur [fineparser.ai](https://www.fineparser.ai/#pricing) : vous recevrez un fichier `.fineparserlicense`. Voir [Licences et formules](/fr/fine-parser/basics/licenses-and-plans).
* Un accès sortant au serveur de licences d'ABBYY. Si votre réseau restreint le trafic sortant, autorisez au préalable les plages indiquées dans [Exigences réseau](/fr/fine-parser/reference/data-privacy#network-requirements).

<Steps>
  <Step title="Obtenir une licence">
    Souscrivez une formule sur [fineparser.ai](https://www.fineparser.ai/#pricing). La formule gratuite vous offre 1 000 pages par mois. Vous recevez un seul fichier `.fineparserlicense` pour votre compte.
  </Step>

  <Step title="Démarrer FineParser">
    Transmettez le contenu de votre fichier de licence dans la variable d'environnement `FINEPARSER_LICENSE_DATA` et publiez le port 8080 :

    ```bash theme={null}
    docker run -d --name fineparser -p 8080:8080 \
      -e FINEPARSER_LICENSE_DATA="$(cat acme.fineparserlicense)" \
      -v fineparser-output:/app/output \
      abbyyteam/fineparser
    ```

    Le volume conserve les résultats de l'analyse. Sans lui, ils disparaissent en même temps que le conteneur.

    <Note>
      Sur un hôte ARM, tel qu'un Mac Apple silicon, ajoutez `--platform linux/amd64` à la commande ci-dessus. L'image est pour l'instant uniquement amd64 et s'exécute en émulation, ce qui est plus lent. Voir [Exécution sur ARM](/fr/fine-parser/basics/configuration#running-on-arm).
    </Note>

    Vérifiez ensuite que la licence a bien été acceptée :

    ```bash theme={null}
    curl -s localhost:8080/healthz
    # {"code":"ok","ready":true,"telemetry":true}
    ```

    Si `ready` vaut `false`, le champ `detail` de la réponse en indique la raison. Voir [Vérification de la licence](/fr/fine-parser/basics/configuration#confirming-the-license).
  </Step>

  <Step title="Soumettre un document">
    ```bash theme={null}
    curl -s -X POST http://localhost:8080/parse \
      -F "file=@invoice.pdf" \
      -F "outputType=doclang"
    ```

    FineParser accepte le document et renvoie immédiatement un identifiant de tâche :

    ```json theme={null}
    {"jobId":"6c4f1f0e-...","file":"invoice.pdf"}
    ```
  </Step>

  <Step title="Attendre la fin du traitement">
    Interrogez la tâche à l'aide de son identifiant jusqu'à ce que `status` soit `successful` :

    ```bash theme={null}
    curl -s http://localhost:8080/jobs/6c4f1f0e-...
    ```

    ```json theme={null}
    {"status":"successful","file":"6c4f1f0e-.../invoice.pdf.doclang"}
    ```

    Une facture d'une page prend quelques secondes. Si `status` vaut `failed`, la réponse contient un champ `error` qui en explique la cause.
  </Step>

  <Step title="Télécharger le résultat">
    Ajoutez la valeur `file` à la suite de `/jobs/` :

    ```bash theme={null}
    curl -OJ http://localhost:8080/jobs/6c4f1f0e-.../invoice.pdf.doclang
    ```

    Le fichier contient la structure et le texte du document au format DocLang :

    ```xml theme={null}
    <doclang>
      <heading level="1">Invoice 4471</heading>
      <table>
        <ched/>Item<ched/>Qty<ched/>Amount<nl/>
        <fcel/>Consulting<fcel/>12<fcel/>$4,800.00<nl/>
      </table>
    </doclang>
    ```

    Pour changer de format, remplacez `doclang` par `json` ou `txt` lors de l'étape de soumission.
  </Step>
</Steps>

<h2 id="next-steps">
  Étapes suivantes
</h2>

<CardGroup cols={2}>
  <Card title="REST API" icon="code" href="/fr/fine-parser/concepts/rest-api">
    Soumission, interrogation, téléchargement et l'ensemble des codes de réponse.
  </Card>

  <Card title="Formats de sortie" icon="file-code" href="/fr/fine-parser/basics/output-formats">
    DocLang, JSON ou texte brut.
  </Card>

  <Card title="Configuration" icon="sliders" href="/fr/fine-parser/basics/configuration">
    Recognition mode, langues et ports.
  </Card>

  <Card title="Agents de codage IA" icon="robot" href="/fr/fine-parser/getting-started/ai-agents">
    Donnez à Claude Code ou à Codex accès à cette documentation.
  </Card>
</CardGroup>
