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

# Zugriff auf Skill-Parameter über die Vantage-API

> Verwenden Sie die Vantage-API, um auf Skill-Parameterwerte von Document- und Process-Skills zuzugreifen und diese zu ändern.

Die Vantage-API ermöglicht es Ihnen, auf Skill-Parameter von Document-Skills und Process-Skills zuzugreifen und deren Werte für einen bestimmten Vorgang zu ändern. Parameter werden als Schlüssel-Wert-Paare vom Typ string übergeben. Über die API gesetzte Werte haben Vorrang vor den in der Vantage-UI gesetzten Werten.

<div id="change-skill-parameter-values">
  ## Werte von Skill-Parametern ändern
</div>

Um die Werte von Skill-Parametern für einen Vorgang zu ändern, erstellen Sie per POST einen neuen Vorgang (oder starten Sie einen) und geben Sie die neuen Werte im `skillParameters`-Body an.

Erstellen Sie einen leeren Vorgang:

```http theme={null}
POST {your-host}/api/publicapi/v1/transactions
```

Oder starten Sie einen Vorgang, mit dem ein bestimmter Skill ausgeführt wird:

```http theme={null}
POST {your-host}/api/publicapi/v1/transactions/launch?skillId={skill-id}
```

Fügen Sie neue Parameterwerte in den Request-Body ein:

<Tabs>
  <Tab title="Windows">
    ```bat theme={null}
    curl -X POST "{your-host}/api/publicapi/v1/transactions" ^
    -H "Authorization: Bearer {token}" ^
    -H "Content-Type: application/json" ^
    -d "{\"skillId\":\"123\",\"skillParameters\":[{\"key\":\"Neuer Parameter\",\"value\":\"Vendors neu\"}]}"
    ```
  </Tab>

  <Tab title="Linux">
    ```bash theme={null}
    curl -X POST '{your-host}/api/publicapi/v1/transactions' \
    -H 'Authorization: Bearer {token}' \
    -H 'Content-Type: application/json' \
    -d '{"skillId":"123","skillParameters":[{"key":"Neuer Parameter","value":"Vendors neu"}]}'
    ```
  </Tab>
</Tabs>

<Note>
  Ein Vorgang kann bis zu 10 Skill-Parameter als Schlüssel-Wert-Paare haben. Schlüssel sind auf 128 Zeichen begrenzt, Werte auf 256.
</Note>

<div id="get-skill-parameter-values">
  ## Skill-Parameterwerte abrufen
</div>

Verwenden Sie eine der folgenden Optionen, um Skill-Parameterwerte abzurufen.

<div id="query-the-skillparameters-endpoint">
  ### Den Endpunkt `skillParameters` abfragen
</div>

Senden Sie eine GET-Anfrage:

```http theme={null}
GET {your-host}/api/publicapi/v1/transactions/{transaction-id}/skillParameters/
```

Antwort:

```json theme={null}
[
  {
    "key": "New parameter",
    "value": "Vendors"
  }
]
```

<div id="download-the-transaction-file">
  ### Die Vorgangsdatei herunterladen
</div>

Senden Sie eine GET-Anfrage, um die Vorgangsdatei herunterzuladen, die Parameterwerte im JSON-Format enthält:

```http theme={null}
GET {your-host}/api/publicapi/v1/transactions/{transaction-id}/files/{file-id}/download
```

<div id="related-topics">
  ## Verwandte Themen
</div>

* [Skill-Parameter](/de/vantage/documentation/skill-designer/skill-parameters/skill-parameters)
* [Document-Skill-Parameter](/de/vantage/documentation/skill-designer/skill-parameters/document-skill-params)
* [Process-Skill-Parameter](/de/vantage/documentation/skill-designer/skill-parameters/process-skill-params)
* [Extract-Aktivität](/de/vantage/documentation/skill-designer/process/extract-activity)
* [Einführung in die API](/de/vantage/developer/api-introduction)