Adres van de GET-connector
Dit is de URL waarmee we verbinding maken om gegevens uit AFAS op te halen. Het ziet er bijvoorbeeld zo uit: https://12345.rest.afas.online/profitrestservices/connectors/Naam
Deze URL wijst naar een specifieke connector in AFAS, waarmee bepaalde data (zoals gebruikersinformatie) kan worden opgevraagd.
XML-token
Om toegang te krijgen tot de gegevens, is een XML-token nodig. Dit token wordt gebruikt om de authenticatie te regelen en ervoor te zorgen dat alleen geautoriseerde verzoeken worden verwerkt.
Het token ziet er als volgt uit: <token><version>1</version><data>xxxxx</data></token>.
Dit token wordt in de header van het verzoek meegestuurd om toegang te verlenen tot de data in AFAS.
Gegevens per gebruiker
Bij het ophalen van gegevens via deze koppeling verwachten we per gebruiker (account) de volgende informatie terug in JSON-formaat:
{
"Id": "123456",
"FirstName": "Lorum",
"LastName": "Ipsum",
"MailAddress": lorum.ipsum@mail.nl,
"GroupId1": "000001",
"GroupName1": "Locatie 1",
"GroupId2": "000002",
"GroupName2": "Locatie 2",
}Waarbij combinaties van groep-ID en naam oneindig opgevolgd kunnen worden.
- Id = Unieke identifier per medewerker
- MailAddress = Uniek e-mailadres
- GroupIdX = Unieke identifier voor locatie X
- GroupNameX = Naam voor locatie X
Filter voor Actieve Vrijwilligers/Medewerkers
Indien wenselijk stel je zelf binnen de GetConnector een filter in om te zorgen dat enkel actieve vrijwilligers worden opgehaald en verwerkt. Dit kan helpen om de gegevens binnen ons systeem up-to-date en relevant te houden.