# API-configuratie ### API's configureren in Dastra API staat voor ***Application Programming Interface***; API's maken het mogelijk om het Dastra platform te verbinden met andere externe tools; De mogelijkheden zijn legio: koppeling met CRM-software om stakeholders automatisch op te halen, synchronisatie van een rechtenmanagementtool met de Dastra-module, etc. Dastra is gebaseerd op de **API-Rest** standaard en in het bijzonder op de volgende HTTP requests: | URI | GET | POST | PUT | PATCH | DELETE | | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | Bronnenverzameling, zoals `http://api.exemple.com/collection/`. | Vangt\_ de URI's op van de bronnen die lid zijn van de verzamelbron in de inhoud van het antwoord. | Maakt\_ een lid resource in de collection resource met behulp van de instructies in de request body. De URI van de aangemaakte lid resource wordt *auto-toegewezen* en geretourneerd in het *Location* headerveld van het antwoord. | Vervangt\_ alle representaties van de lidbronnen van de verzameling door de representatie in de verzoektekst, of *maakt* de verzamelingbron als deze niet bestaat. | *updates* alle representaties van de lidbronnen van de verzamelbron met behulp van de instructies in de verzoektekst, of *creëert* de verzamelbron als deze niet bestaat. | Verwijdert alle representaties van bronnen die lid zijn van de verzamelbron. | | Lid bron, zoals `http://api.exemple.com/collection/item3` | Haalt\_ een representatie van de lidbron op in de body van het antwoord. | Creëert\_ een member resource in de member resource met behulp van de instructies in de request body. De URI van de aangemaakte member resource wordt *auto-toegewezen* en geretourneerd in het *Location* headerveld van het antwoord. | Vervangt\_ alle representaties van de lidbron, of *maakt* de lidbron als deze niet bestaat, met de representatie in de verzoektekst. | Werkt\_ alle representaties van de lidbron bij, of *maakt* de lidbron aan als deze niet bestaat, met behulp van de instructies in de verzoektekst. | Verwijdert alle representaties van de lidbron. | Bron : [*wikipedia*](https://en.wikipedia.org/wiki/REST); Verschillende API's kunnen worden geconfigureerd met Dastra. De lijst met API's is hier beschikbaar: ### Beperkingen Een http-verzoeklimiet is ingesteld op 500/min of 10000/10min. Beveiligingsopties (met name IP-filtering) zijn niet van toepassing op API's ### Blootstelling van aangepaste velden in de Dastra API In Dastra is het mogelijk om in de API [aangepaste velden](https://github.com/Dastrateam/dastra-doc-nl/blob/main/features/generalites/champs-personnalises.md) te tonen die ontworpen zijn vanuit je Dastra-workspace. Aangepaste velden zijn specifiek voor elke werkruimte. Om ze mee te nemen in de Dastra API, moet je eerst de naam van hun variabele definiëren in de aangepaste velddefinitie:
{% content-ref url="" %} {% endcontent-ref %} De meeste entiteiten die via de API gewijzigd kunnen worden, hebben een veld met de naam "**customFields**" dat je kunt wijzigen Als je velden definieert met de volgende variabele namen binnen je werkruimte: * my\_field\_string: een "Tekst" veld * my\_field\_booleen: een "aankruisvakje" veld * my\_field\_numeric : een "Nummer" veld * my\_field\_checkbox: een "Checkbox" veld Het is mogelijk om deze informatie als volgt aan te passen ```json { "label": "Google Analytics 4", ... "customFields": { "mon_champ_string": "Waarde van mijn veld", "mon_champ_booleen": true, "mon_champ_numeric": 1, "mon_champ_checkbox"!:["Appel", "Banaan"], ...a } } ``` ### Tags Om tags bloot te leggen in de Dastra API, moet je ze zoeken in het tags eindpunt voordat je ze toevoegt: /v1/ws/{workspaceId}/Tags ### {% hint style="info" %} **TIP**: gebruik alleen API's als je weet wat je doet! {% endhint %} Je kunt de API beheerinterface in Dastra vinden op dit adres: --- # 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/nl/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.