> For the complete documentation index, see [llms.txt](https://docs.videc.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videc.de/acron-9.3/ac_admin/anlagenuebersicht/anlage/dienste_und_anwendungen/restapi.md).

# REST API

## REST API

Die REST API ist eine Programmierschnittstelle, die ausgewählte ACRON Funktionen für Drittanbieter-Anwendungen zur Verfügung stellt.

Details zur Konfiguration und zur Verwendung können der API-Entwickler-Dokumentation entnommen werden.

Voraussetzungen

* Bei den [Lizenzeinstellungen](https://github.com/Dataforum-Software/gitbook/blob/master/acron/9.3/de/admin/ac_designer/anlage/register-lizenz.md) muss bei der [Zugriffsart](https://github.com/Dataforum-Software/gitbook/blob/master/acron/9.3/de/admin/ac_designer/anlage/register-lizenz.md#zugriffsart) eine der Optionen mit Beteiligung des Datenbank-Servers ausgewählt sein.
* Die [Benutzerverwaltung](https://github.com/Dataforum-Software/gitbook/blob/master/acron/9.3/de/admin/ac_designer/benutzerverwaltung/benutzergruppen-benutzer.md#bv-aktiv) muss aktiviert sein und
* der entsprechende Benutzer muss dort mit [Name und Passwort](https://github.com/Dataforum-Software/gitbook/blob/master/acron/9.3/de/admin/ac_designer/benutzerverwaltung/benutzer/benutzerdaten.md) vorhanden sein.

## Arbeitsbereich <a href="#arbeitsbereich" id="arbeitsbereich"></a>

### Server

#### Status

Status des REST API Servers

### Lizenzreservierungen <a href="#lizenzreservierungen" id="lizenzreservierungen"></a>

#### Anzahl License Consumer für Datenzugriff

Möglichkeit, [License Consumer](https://github.com/Dataforum-Software/gitbook/blob/master/acron/9.3/de/admin/glossar/license_consumer.md) für die REST API zu reservieren. Diese werden sofort von der [Anzahl verfügbarer License Consumer](/acron-9.3/ac_admin/lokalelizenz.md#lizenzinformationen) abgezogen.

Hinweis

Je mehr License Consumer beim Datenzugriff für die REST API reserviert werden, desto schneller ist der Zugriff auf die Daten.

### Konfiguration

#### FQDN

Vollqualifizierter Host- bzw. Domainname des REST API Servers

#### IP-Adresse

Auswahl des zu verwendenden Netzwerkadapters anhand seiner IP-Adresse

#### Port

Vergebene Portnummer (erlaubte Portnummern zwischen 3900 und 9000)

#### Zertifikat

Es gibt zwei verschiedene Möglichkeiten, ein Zertifikat auszuwählen:

* Zertifikat aus einer Zertifikatsdatei importieren

  Über die Schaltfläche 'Zertifikat importieren \*.cer- oder \*.pfx-Datei auswählen.
* Selbst signiertes Zertifikat erstellen

  Über die Schaltfläche 'Zertifikat generieren' im Folgedialog ein Passwort für die Zertifikatsdatei setzen. Die Zertifikatsdatei (pfx) wird im ACRON Konfigurationspfad abgelegt. Pro Anlage kann maximal eine Zertifikatsdatei existieren.

Hinweis

Selbst signierte Zertifikate sind nur für Entwicklungs- und Testzwecke geeignet, für den Produktivbetrieb ist zwingend ein durch eine vertrauenswürdige Zertifizierungsstelle ausgestelltes Zertifikat notwendig.

Über die Schaltfläche 'Zertifikat exportieren‘ kann ein selbst signiertes Zertifikat ohne den privaten Schlüssel als \*.cer-Datei auf dem Desktop abgelegt werden.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.videc.de/acron-9.3/ac_admin/anlagenuebersicht/anlage/dienste_und_anwendungen/restapi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.