Page Comparison

...

Triaspect doet dat zelf niet, en heeft daarvoor ook geen partnerorganisatie gezocht. Mocht je op zoek zijn naar een organisatie die je hierbij kan helpen, dan kunnen we je de namen geven van organisaties die dit ook voor andere klanten doen.

Anchor
Toegang Toegang

Hoe krijg ik (of mijn

...

leverancier) toegang tot de API?

Om te zorgen dat er op een goede manier gebruik gemaakt wordt van de API, hebben we het volgende proces ingericht.

1. Je vraagt als organisatie via de servicedesk toegang aan tot de API op de testomgeving. Hiervoor moeten de relevante IP-adressen toegevoegd worden aan de Triaspectservers. Je krijgt een certificaat, een gebruikersnaam en een wachtwoord van de SD. Hiermee kun je verbinding maken met de test-omgeving van de API. Op deze testomgeving staan alle tabellen die ook beschikbaar zijn op acceptatie en productie. De data in de tabellen is echter gefingeerd. Je kunt hier dus wel kijken wat de structuur is van de data die je terugkrijgt, en je kunt kijken of je überhaupt de data kunt benaderen, en of je de data kunt data toevoegen.

2. Op basis van je tests schrijf je een ontwerp. Van dat ontwerp maak je een uittreksel van een half a-4tje waarin staat wat je wilt bereiken, welke endpoints je wilt aanroepen en hoe vaak je dat per minuut verwacht te doen. Vooralsnog hebben we een maximum van 50 aanroepen per seconde, met een sliding window. Dit ontwerp wordt gecontroleerd door onze technisch consultants. Zij kijken niet naar de functionaliteit, maar naar de techniek en het aantal aanroepen.

3. Als het ontwerp door Triaspect geaccordeerd is, kan toegang tot de acceptatieomgeving aangevraagd worden, weer via de servicedesk. Hiervoor wordt een nieuw certificaat uitgegeven.

4. Je test je programma op de acceptatieomgeving. Omdat hier jullie eigen data op staat, kan het zijn dat er nog wat aangepast moet worden aan het programma. Dat is geen probleem. Er hoeft niet opnieuw een ontwerp opgeleverd te worden.

5. Ben je tevreden met hoe het programma werkt, dan vraag je toegang aan tot de productiedata. Daarvoor krijg je weer een nieuw certificaat. Voordat dat certificaat wordt uitgegeven, doet een technisch consultant een check op het gebruik van de API op de acceptatieomgeving. Als dat nog iets bijzonders oplevert, dan wordt daarover nog even contact opgenomen.

...

Het gebruik van de medewerkersynchronisatie in combinatie met de API kan heel handig zijn (zie hieronder) maar het is wel zaak om goed op te letten dat ze elkaar niet in de weg lopen. Denk bijvoorbeeld aan dat de synchronisatie die alle medewerkers deactiveert die niet in de synchronisatie zitten. Dus als je de API gebruikt om nieuwe medewerkers toe te voegen die niet in de synchronisatie zitten, dan worden die bij de eerstvolgende synchronisatie weer gedeactiveerd.

...

• Zorg dat je een connectie kunt maken met de API. Hiervoor moet je het certificaat meesturen met je aanroepen.

• Haal alle gebruikers individueel uit TriasWeb (op basis van het emailadres).

• Zet ze in het geheugen van je programma. Een endpoint waarmee in 1 keer van alle gebruikers de identificatie kan worden opgehaald wordt nog gemaakt.

• Je moet een lijst hebben met alle medewerkers die actief moeten zijn of worden in TriasWeb. In deze lijst moet al kenmerk 2 opgenomen van hierboven opgenomen zijn. Deze lijst verwerk je in je programma:

  • Vergelijk de gebruiker uit de lijst met de medewerker in het geheugen.

  • Als er een verschil is, dan roep je het update-endpoint aan voor de gebruiker in TriasWeb. Als je wilt geef je rollen (alleen beschikbaar in API), koppelcodes (kenmerk 4), en hoofdverantwoordelijkheid voor een OE (alleen beschikbaar in API) mee. Activeer de gebruiker om kenmerk 3 te realiseren.

  • Verwijder daarna de medewerker uit het geheugen.

  • Als er geen verschil is, activeer de gebruiker om kenmerk 3 te realiseren. Daarna verwijder je de medewerker uit het geheugen.

  • Als je nog medewerkers in je lijst hebt, die je niet in je geheugen hebt, dan maak je een nieuwe gebruiker aan in TriasWeb.

  • Als je alle medewerkers uit de lijst vergeleken hebt met de gebruikers in TriasWeb, dan roep je het verwijder-endpoint aan voor de overgebleven gebruikers in het geheugen (kenmerk 1).

...

• Zorg voor een lijst met alle actuele ZZP-ers. Deze moet je twee keer verwerken, met (bijvoorbeeld) een week ertussen.

• Per ZZP-er roep je de endpoint GET /api/users?method=email&value=iemand@organisatie.nl op basis van de identificatie (email in dit voorbeeld) aan.

• Als je 404 terugkrijgt is deze persoon niet aanwezig in TriasWeb. Dan roep je de PUT /api/users aan met de relevante parameters in de request body. Zorg ervoor dat handmatig deactiveren aangezet wordt ("isDeactivationManual": true) zodat de medewerkersynchronisatie deze gebruiker niet verwijdert.

• Als de gebruiker bestaat, dan update je indien nodig. Zorg ervoor dat handmatig deactiveren aangezet wordt (zet "isDeactivationManual": true in de request body) zodat de medewerkersynchronisatie deze gebruiker niet verwijdert.

• Na een week (of hoe lang je ook wilt) verwerk je de lijst nogmaals, maar verwijder je de gebruikers die op de lijst staan, uit TriasWeb. Deactiveer de gebruiker met endpoint.
  /api/users/close-account?method=email&value=iemand@organisatie.nl

• Voer het programma meteen weer uit met een nieuwe lijst met ZZP-ers.

...