Skip to main content

GetPersonAgenda

Met deze method kan de Pynter-agenda van een gebruiker worden opgehaald. Hierin staat trainingen met een of meer fysieke trainingsdagen.

Let op: Gebruik geen GET-requests. Deze worden in plaintext verstuurd, en zijn dus niet veilig.

POST /service/apiservice.asmx/GetPersonAgenda HTTP/1.1
Host: domein.pynter.nl
Content-Type: application/x-www-form-urlencoded
Content-Length: length

username=string&password=string&identifier=string

Bij het succesvol aanroepen ziet een respons er als volgt uit:

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<ApiResponseOfListOfAgendaDTO>
  <Succes>true</Succes>
  <Contents></Contents>
</ApiResponseOfListOfAgendaDTO>

`Contents` bevat een of meer keer een `AgendaDTO` object. `AgendaDTO` is als volgt gestructureerd:

<AgendaDTO>
  <!-- De unieke ID van het agenda-item. -->
  <id>int</id>
  
  <!-- De naam van het agenda-item. -->
  <agendaItem>string</agendaItem>
  
  <!-- De datum van het agenda-item in het format dd MMMM yyyy, bijvoorbeeld "28 januari 2025". -->
  <agendaDatum>string</agendaDatum>

  <!-- De unieke ID van de lichting waar dit agenda-item onderdeel van is. -->
  <classID>int</classID>

  <!-- Het personeelsnummer van de medewerker. -->
  <externalIdentifier>string</externalIdentifier>
  
  <!-- De inschrijvingsstatus van het agenda-item.
    0: Aangemeld
       De medewerker is aangemeld voor het agenda-item, maar wacht nog op goedkeuring en/of planning.
    1: Goedgekeurd door leidinggevende
       De leidinggevende heeft de aanmelding goedgekeurd, maar de planner nog niet.
    2: Afgewezen
       De aanmelding is afgekeurd of geannuleerd.
    3: Ingepland
       De medewerker is ingeschreven.
  -->
  <State>int</State>

  <!-- Is de bijbehorende lichting geannuleerd Ja/Nee. -->
  <Cancelled>boolean</Cancelled>
  
  <!-- Ongebruikt. Heeft altijd de waarde "training". -->
  <type>string</type>
  
  <!-- Ongebruikt. Heeft altijd de waarde "#". -->
  <agendaHyperlink>string</agendaHyperlink>

  <!-- Ongebruikt. Heeft altijd de waarde "".  -->
  <agendaTarget>string</agendaTarget>
</AgendaDTO>