> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/nl/features/integrations/custom-http.md).

# HTTP / Custom API

Roep elke externe API aan vanuit uw workflowregels met een eigen HTTP-verzoek

## Werking van de integratie

Met de integratie HTTP / Custom API kunnen uw workflowregels elk platform aanroepen dat een HTTP-API aanbiedt, wanneer een regel wordt geactiveerd: een ticketingtool, een ITSM-systeem, een interne dienst of een automatiseringshub. U stelt het verzoek zelf samen: de methode, de URL, de headers en een JSON- of XML-body die is opgebouwd uit de gegevens van het item. Gebruik deze integratie wanneer er voor uw tool geen native connector bestaat.

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-2f716a5b60f22eb67a8a05e23654a71f465f3e5d%2Fcustom-http-action.png?alt=media" alt="Ontwerper van workflowregels met de actie Send an HTTP request: bovenaan methode en URL, het tabblad Body geopend op een JSON Liquid-sjabloon"><figcaption><p>De workflowactie Send an HTTP request</p></figcaption></figure>

## Vereisten

* Een eindpunt op het doelplatform dat een HTTP-verzoek accepteert (GET, POST, PUT, PATCH of DELETE) en de bijbehorende referenties: een API-sleutel of token, een gebruikersnaam en wachtwoord, of een OAuth 2.0-client (client-ID, clientgeheim en token-URL).
* De machtiging Integraties op de werkruimte, om de integratie te activeren, verbindingen te beheren en HTTP-verzoekacties toe te voegen of te wijzigen. Ontwerpers van workflows zonder deze machtiging kunnen de rest van een regel die zo'n actie bevat nog wel bewerken, of de actie verwijderen, maar ze niet toevoegen of wijzigen.
* Een doel dat bereikbaar is via internet: Dastra blokkeert verzoeken naar privé- of interne netwerkadressen.

## Installatie

1. Open in Dastra **Instellingen voor werkruimte** > **Integraties** en selecteer **HTTP / Custom API**.
2. Activeer het gebruiksscenario: in deze stap voert u geen referenties in, de schakelaar activeert alleen de actie voor de werkruimte.
3. Klik op **Beheer de verbindingen** en voeg één verbinding per doelplatform toe. Een verbinding bevat één manier van authenticeren:

   * **API key / token**: de sleutel, de header die ze draagt (standaard `Authorization`) en een optioneel voorvoegsel voor de waarde (standaard `Bearer` wanneer de header `Authorization` is). Laat het voorvoegsel leeg voor een header zoals `X-API-Key`.
   * **Basis (inloggegevens / API-sleutel)**: een gebruikersnaam en een wachtwoord.
   * **OAuth 2.0 (client credentials)**: een token-URL, een client-ID en een clientgeheim (plus optionele scopes). Dastra vraagt de toegangstokens zelf aan en vernieuwt ze voordat ze verlopen.

   De optionele **Base URL** wordt alleen gebruikt voor de verbindingstest: Dastra stuurt er een GET naartoe met de referenties en verwacht een succesvol antwoord.

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-ffd8545041d08e68d08c711d34c9952dd36b9666%2Fcustom-http-install.png?alt=media" alt="Pagina van de integratie HTTP / Custom API met het geactiveerde gebruiksscenario en de knop Beheer de verbindingen"><figcaption><p>De integratie is een activeringsschakelaar, de referenties staan op de verbindingen</p></figcaption></figure>

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-04b676e97cd104d589393dd2a9a0a1e5fc3285eb%2Fcustom-http-connexion.png?alt=media" alt="Venster Voeg een verbinding toe met de methode API key / token: sleutel, naam van de header, voorvoegsel en Base URL"><figcaption><p>Een verbinding met een API-sleutel toevoegen</p></figcaption></figure>

{% hint style="info" %}
De referenties staan op de verbinding, nooit in de workflowregel. Meerdere regels kunnen één verbinding delen en een werkruimte kan zoveel verbindingen hebben als er doelplatformen zijn. Het beheer van de verbindingen toont hoeveel regels elke verbinding gebruiken.
{% endhint %}

## Een verzoek versturen vanuit een workflowregel

Zodra de integratie actief is, biedt de ontwerper van workflowregels de actie **Send an HTTP request**:

* **Method** en **URL**: de URL moet absoluut zijn (`https://…`). De host ligt vast, het pad en de query string kunnen variabelen bevatten.
* Tabblad **Authentication**: kies de te gebruiken verbinding, of **No authentication** voor een openbaar eindpunt. U kunt hier ook een verbinding aanmaken.
* Tabblad **Headers**: maximaal 20 aangepaste headers. De waarden accepteren variabelen. De authenticatieheader van de verbinding wint altijd van een header met dezelfde naam.
* Tabblad **Body** (POST, PUT en PATCH): kies het formaat (**JSON**, **XML** of **No body**) en schrijf de body als sjabloon.

Typ `{{` in de URL, in een headerwaarde of in de body om de velden van het item in te voegen (label, eigenaar, datums, aangepaste velden enzovoort). Ze worden ingevuld wanneer de regel wordt geactiveerd. De ingevulde body moet geldige JSON of XML zijn, anders wordt er niets verstuurd en wordt de uitvoering van de regel als fout gelogd.

### Het verzoek testen

**Test the request** vult de URL, de headers en de body in met een echt item van uw werkruimte en valideert ze. De authenticatieheader wordt getoond met een gemaskeerd geheim. **Preview** verstuurt niets. **Send the request** voert de echte aanroep uit en toont de antwoordstatus van het doel en, bij een fout, het begin van de foutmelding.

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-bc6d8dc19d51acaa7a397d9cb132b46d0d2a1460%2Fcustom-http-test.png?alt=media" alt="Testvenster na Send the request: resultaat van de levering, ingevulde URL, gemaskeerde header en ingevulde body"><figcaption><p>Proefrun van het verzoek met een echt item</p></figcaption></figure>

### Het verzoek genereren met AI

Met de AI-assistent van Dastra stelt de knop naast het URL-veld (**Generate with AI**) het hele verzoek op: beschrijf wat het moet doen en plak de payload die het doel verwacht, of een fragment uit de API-documentatie ervan. Alleen de namen en typen van de velden van het item worden met de assistent gedeeld, nooit uw gegevens en nooit uw referenties. Het ontwerp bevat nooit authenticatie: die blijft op de verbinding staan. Controleer het ontwerp en gebruik daarna de testknop.

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-70cd677afdf148aac9325f0833ef09d00f60fd2f%2Fcustom-http-ai.png?alt=media" alt="Venster Generate the request with AI met de velden voor de instructie en de geplakte payload"><figcaption><p>Het verzoek opstellen vanuit een instructie en de verwachte payload</p></figcaption></figure>

## Logs

Elke levering die een regel uitvoert, wordt vastgelegd in de integratielogs van het gebruiksscenario (**Toon logs** in het menu van het gebruiksscenario): de regel, de methode, de doelhost en de antwoordstatus, nooit de volledige URL, de headers of de body. De uitvoeringslogs van de regel zelf bewaren de gedetailleerde foutmelding. Een regel die voor hetzelfde item blijft mislukken, probeert het na drie pogingen niet meer.

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-7a978bf85c96f8464e3b55e61c924b3533032e21%2Fcustom-http-logs.png?alt=media" alt="Paneel met de integratielogs van de HTTP-leveringen, met regels voor geslaagde en mislukte leveringen"><figcaption><p>Integratielogs van de HTTP-leveringen</p></figcaption></figure>

## Deactiveren en verwijderen

Het gebruiksscenario uitschakelen, het verwijderen of een verbinding verwijderen schakelt de workflowregels die ervan afhangen automatisch uit (ze worden niet verwijderd), zodat niets ongemerkt blijft mislukken. Schakel de regels opnieuw in zodra de afhankelijkheid is hersteld.

{% hint style="warning" %}
Verzoeken verlopen na 15 seconden. Een 2xx-antwoord geldt als geslaagd. Al het andere wordt gelogd als een mislukking, met het begin van het antwoord van het doel. Verzoeken naar privé- of interne adressen worden altijd geblokkeerd.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/nl/features/integrations/custom-http.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
