GetPersonByEmail

Het ophalen van een gebruiker binnen Pynter via de GetPersonByEmail endpoint kan er als volgt uit zien:

POST /service/apiservice.asmx HTTP/1.1
Host: domein.acc.pynter.nl
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetPersonByEmail xmlns="/service/ApiService.asmx">
      <username>string</username>
      <password>string</password>
      <email>int</email>
    </GetPersonByEmail>
  </soap12:Body>
</soap12:Envelope>

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"?>
<ApiResponseOfPerson xmlns="/service/ApiService.asmx">
  <Success>boolean</Success>
  <Contents xmlns="ApiPerson"></Contents>
  <Error>string</Error>
</ApiResponseOfPerson>

De Contents zal de volgende waarden van een ApiPerson bevatten:

<ApiPerson>
    <!-- De unieke identificatie van de persoon binnen Pynter. -->
    <Id>int</Id>

    <!-- Het medewerkernummer voor deze persoon. Kan gebruikt worden om de persoon op te wijzigen of op te halen. Moet uniek zijn. -->
    <ExternalIdentifier>string</ExternalIdentifier>

    <!-- De voornaam. -->
    <FirstName>string</FirstName>

    <!-- OPTIONEEL: Het tussenvoegsel. -->
    <Insertion>string</Insertion>

    <!-- De achternaam exclusief tussenvoegsel. -->
    <FamilyName>string</FamilyName>

    <!-- Een zakelijk e-mailadres voor de persoon. -->
    <Email>string</Email>

    <!-- Het autorisatieniveau van de persoon. -->
    <!-- Zie de opmerking onder dit blok voor meer uitleg. -->
    <AccountLevel></AccountLevel>

    <!-- Of deze persoon een manager is of niet. -->
    <IsManager>boolean</IsManager>

    <!-- De naam van de functie. -->
    <FunctionName>string</FunctionName>

    <!-- De unieke identificatie van de functie binnen Pynter. -->
    <FunctionId>int</FunctionId>

    <!-- De naam van de divisie / locatie van de persoon. -->
    <DivisionName>string</DivisionName>

    <!-- De unieke identificatie van de divisie binnen Pynter. -->
    <DivisionId>int</DivisionId>

    <!-- De kostenplaats voor de persoon. -->
    <CostCentre>string</CostCentre>

    <!-- OPTIONEEL: De telefoonnummer. -->
    <PhoneNumber>string</PhoneNumber>

    <!-- OPTIONEEL: Wanneer het contract van kracht is. -->
    <ContractStartTime>datetime</ContractStartTime>

    <!-- OPTIONEEL: Wanneer het contract afloopt. -->
    <ContractEndTime>datetime</ContractEndTime>

    <!-- De unieke identificatie van de manager voor deze persoon binnen Pynter. -->
    <ManagerId>int</ManagerId>
</personCreate>

Voor meer informatie over AccountLevel kan je de pagina over Autorisatie inzien.