Dit artikel legt uit hoe je onze REST API kunt gebruiken om organisaties op te halen, te bewerken of toe te voegen.

Aan de slag

➡️ Het is belangrijk om eerst een token te verkrijgen. Controleer dit artikel om te weten te komen hoe u een token kunt krijgen.

Authenticatie van API-verzoeken gebeurt via een Bearer-token via de header van het verzoek.
Voeg daarom de volgende header toe aan elk verzoek dat u naar onze API stuurt:

X-Authorization: Bearer [token]

Endpoint-URL

Je dient een GET-, PUT- of POST-verzoek te sturen naar het volgende endpoint-adres. Afhankelijk van de gekozen methode in het http-verzoek, wordt bepaald of je wil lezen, schrijven of toevoegen.

Endpoint

https://{bedrijfsdomein}.neoforce.app/api/v1/tickets

Tickets ophalen van de API

Stuur een GET-verzoek naar het endpoint. Het is mogelijk om te filteren op kolommen. Voeg de filter [kolom_naam]=filter toe aan de URL. Dit zal alle tickets retourneren die overeenkomen met je filter.

Voorbeeld: haal de 10 nieuwste tickets op.

https://{bedrijfsdomein}.neoforce.app/api/v1/tickets/?filter[active]=1&limit=10&order=desc&sortBy=id

Filteren van data

Soms wil je al een bepaalde filtering meegeven zodat je niet alle resultaten terugkrijgt. Dat is mogelijk door middel van de ‘parameter’ filter.

Tickets toevoegen via de API

Stuur een POST-verzoek naar het endpoint. Stuur de kolommen die je wil toevoegen als een JSON-array in het body van het verzoek.

URL:

https://{bedrijfsdomein}.neoforce.app/api/v1/tickets

{
    "title": "Test titel",
    "request": "Test verzoek",
    "typeID": "1",
    "statusID": "1",
    "assets": [
    {
    "type": "datasets_obj_test_schema",
    "id": "3",
    "ref": "testschema"
    }
    ],
    "startdate": "2026-02-11 13:43:00",
    "targetdate": "2026-02-23 13:23:00",
    "enddate": "2026-02-11 13:43:00",
    "personID": "1",
    "organisationID": "1"
}