Data ophalen uit Tim via API (voorbeeld Postman)

Met deze handleiding kun je rechtstreeks data uit Tim ophalen via de API en testen met Postman.

Voorbeeld: Tim lijsten

Wat heb je nodig?

Voor de koppeling heb je de volgende gegevens nodig:

• API-key (via Softmakers)
• E-mailadres van de Tim-Api gebruiker
• DataSetName (naam van dataset in Tim), zelf aanmaken in Tim
• DataListName (naam van de lijst binnen de dataset)
• TenantId (via Softmakers)

API endpoint

https://start.timsaas.com/timapi/api/ReportDataSetExport

Hoe werkt het?

Je doet een HTTP GET request naar het endpoint met parameters en headers.

De API geeft vervolgens JSON terug met de data uit Tim.

Belangrijk:

• De kolommen komen rechtstreeks uit de DataList in Tim
• Er is geen vast schema

Testen met Postman (stap-voor-stap)

1. Maak een nieuwe request

• Open Postman
• Klik op New → HTTP Request
• Zet methode op GET

2. Vul de URL in

https://start.timsaas.com/timapi/api/ReportDataSetExport

3. Voeg query parameters toe

In Postman onder Params:

4. Voeg headers toe

In tab Headers:

5. Klik op “Send”

✅ Je krijgt nu een response terug met JSON data.

Wat krijg je terug?

De response bevat:

• Eén object met daarin een lijst (array) van records
• Elke record = één rij uit de DataList
• Kolommen = exact zoals ingericht in Tim

Voorbeeld response (vereenvoudigd), zelf in terichten in Tim

Wanneer wordt data opgehaald?

Elke keer dat je de request uitvoert:

• krijg je de actuele stand van de DataList

Aandachtspunten

• Kolomnamen kunnen wijzigen → kan je koppeling breken
• DataSetName en DataListName moeten exact kloppen
• Geen vast datamodel of versiebeheer
• API-key goed beveiligen

Samenvatting

• Data wordt opgehaald via een simpele HTTP GET
• Resultaat is JSON
• Je kunt dit direct gebruiken in:
  • Postman (testen)
  • C#
  • Python
  • andere integraties