# API-Konfiguration ### APIs in Dastra konfigurieren API steht für ***Application Programming Interface*** (Programmierschnittstelle). APIs ermöglichen es, die Dastra-Plattform mit anderen externen Tools zu verbinden. Die Möglichkeiten sind vielfältig: Verbindung mit einer CRM-Software zur automatisierten Übernahme von Beteiligten, Synchronisation eines Tools zur Verwaltung von Betroffenenrechten mit dem Dastra-Modul usw. Dastra basiert auf dem Standard **API-Rest** und insbesondere auf den folgenden HTTP-Anfragen: | URI | GET | POST | PUT | PATCH | DELETE | | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | | Sammlungsressource, wie `http://api.beispiel.com/collection/` | *Ruft* die URIs der Mitgliedsressourcen der Sammlungsressource im Antwortkörper ab. | *Erstellt* eine Mitgliedsressource in der Sammlungsressource unter Verwendung der Anweisungen des Anfragekörpers. Die URI der erstellten Mitgliedsressource wird *automatisch zugewiesen* und im *Location*-Header-Feld der Antwort zurückgegeben. | *Ersetzt* alle Darstellungen der Mitgliedsressourcen der Sammlungsressource durch die Darstellung im Anfragekörper oder *erstellt* die Sammlungsressource, wenn sie nicht existiert. | *Aktualisiert* alle Darstellungen der Mitgliedsressourcen der Sammlungsressource unter Verwendung der Anweisungen des Anfragekörpers oder *erstellt gegebenenfalls* die Sammlungsressource, wenn sie nicht existiert. | *Löscht* alle Darstellungen der Mitgliedsressourcen der Sammlungsressource. | | Mitgliedsressource, wie `http://api.beispiel.com/collection/item3` | *Ruft* eine Darstellung der Mitgliedsressource im Antwortkörper ab. | *Erstellt* eine Mitgliedsressource in der Mitgliedsressource unter Verwendung der Anweisungen des Anfragekörpers. Die URI der erstellten Mitgliedsressource wird *automatisch zugewiesen* und im *Location*-Header-Feld der Antwort zurückgegeben. | *Ersetzt* alle Darstellungen der Mitgliedsressource oder *erstellt* die Mitgliedsressource, wenn sie nicht existiert, durch die Darstellung im Anfragekörper. | *Aktualisiert* alle Darstellungen der Mitgliedsressource oder *erstellt gegebenenfalls* die Mitgliedsressource, wenn sie nicht existiert, unter Verwendung der Anweisungen des Anfragekörpers. | *Löscht* alle Darstellungen der Mitgliedsressource. | Quelle: [*Wikipedia*](https://fr.wikipedia.org/wiki/Representational_state_transfer) Mit Dastra ist es möglich, mehrere APIs zu konfigurieren. Die Liste der APIs ist hier verfügbar: ### Einschränkungen Ein HTTP-Anfragelimit ist auf 500/Min. oder 10.000/10 Min. festgelegt. Die Sicherheitsoptionen (insbesondere IP-Filterung) gelten nicht für APIs. ### Bereitstellung benutzerdefinierter Felder in der Dastra-API In Dastra ist es möglich, [benutzerdefinierte Felder](/de/features/generalites/custom-fields.md), die in Ihrem Dastra-Mandanten erstellt wurden, über die API bereitzustellen. Benutzerdefinierte Felder sind für jeden Mandanten spezifisch. Um sie in der Dastra-API zu berücksichtigen, muss zunächst der Variablenname in der Definition des benutzerdefinierten Feldes festgelegt werden:
{% content-ref url="/pages/78pjV82cr1qqv9TqE6RM" %} [Benutzerdefinierte Felder](/de/features/generalites/custom-fields.md) {% endcontent-ref %} Die meisten über die API bearbeitbaren Entitäten stellen ein Feld namens "**customFields**" bereit, das Sie ändern können. Wenn Sie die Felder mit den folgenden Variablennamen in Ihrem Mandanten definieren: * mein\_string\_feld: ein "Text"-Feld * mein\_boolean\_feld: ein "Kontrollkästchen"-Feld * mein\_numerisches\_feld: ein "Zahl"-Feld * mein\_checkbox\_feld: ein "Kontrollkästchen"-Feld (Mehrfachauswahl) Dann können diese Informationen wie folgt geändert werden ```json { "label": "Google Analytics 4", ... "customFields": { "mon_champ_string": "Valeur de mon champ", "mon_champ_booleen": true, "mon_champ_numeric": 1, "mon_champ_checkbox"!:["Pomme","Banane"], ...a } } ``` ### Der Fall der Tags Um Tags in der Dastra-API bereitzustellen, müssen Sie diese zunächst über den Tags-Endpunkt abrufen: /v1/ws/{workspaceId}/Tags {% hint style="info" %} **HINWEIS**: Verwenden Sie APIs nur, wenn Sie wissen, was Sie tun! {% endhint %} Die API-Verwaltungsoberfläche in Dastra finden Sie unter dieser Adresse: --- # Agent Instructions: 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://doc.dastra.eu/de/api-references/configuration-api.md?ask= ``` 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.