Login

For authorization the following steps need to be completed:

Step 1: Create a session with username and password.

The username and password are created in Bricks Huisarts by the practice.

Request

<?xml version="1.0" encoding="utf-16"?>
<Tetra_Switchboard_Security_CreateSession_Verzoek xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Id="-1000">
  <Identificatie Id="-1000" />
  <Username>e@mail.nl</Username>
  <Password>123</Password>
</Tetra_Switchboard_Security_CreateSession_Verzoek>

Response

<?xml version="1.0" encoding="utf-16"?>
<Tetra_Switchboard_Security_CreateSession_Antwoord xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Id="-1000">
  <CommunicatieStatus>OZB_Communicatie_Status_Verzoek_is_geslaagd</CommunicatieStatus>
  <SessionId>e5ce2cd9-bc8a-463d-9dbd-3c239e2e8604</SessionId>
</Tetra_Switchboard_Security_CreateSession_Antwoord>

Next step

After this, the SessionId should be put in a cookie to be used for all further communication.

Step 2: Send an SMS

The text message will be send by the Tetra B.V. servers.

Request

<?xml version="1.0" encoding="utf-16"?>
<Tetra_Switchboard_Security_StuurSMS_Verzoek xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Id="-1001">
  <Identificatie xsi:type="OZB_Communicatie_Identificatie_GebruikerSessie" Id="-1001">
    <Sessie>e5ce2cd9-bc8a-463d-9dbd-3c239e2e8604</Sessie>
  </Identificatie>
  <ZenderIP />
  <OntvangerEntiteit />
</Tetra_Switchboard_Security_StuurSMS_Verzoek>

Response

<?xml version="1.0" encoding="utf-16"?>
<Tetra_Switchboard_Security_StuurSMS_Antwoord xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Id="-1000">
  <CommunicatieStatus>OZB_Communicatie_Status_Verzoek_is_geslaagd</CommunicatieStatus>
</Tetra_Switchboard_Security_StuurSMS_Antwoord>

Step 3: Upgrade session with the SMS-code

Send the SMS-code that the user received on his mobile to the Bricks Switchboard API.

Request

<?xml version="1.0" encoding="utf-16"?>
<Tetra_Switchboard_Security_SMSAntwoord_Verzoek xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Id="-1001">
  <Identificatie xsi:type="OZB_Communicatie_Identificatie_GebruikerSessie" Id="-1001">
    <Sessie>e5ce2cd9-bc8a-463d-9dbd-3c239e2e8604</Sessie>
  </Identificatie>
  <ZenderIP />
  <OntvangerEntiteit />
  <SMS>yuk123</SMS>
</Tetra_Switchboard_Security_SMSAntwoord_Verzoek>

Response

<?xml version="1.0" encoding="utf-16"?>
<Tetra_Switchboard_Security_SMSAntwoord_Antwoord xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Id="-1000">
  <CommunicatieStatus>OZB_Communicatie_Status_Verzoek_is_geslaagd</CommunicatieStatus>
</Tetra_Switchboard_Security_SMSAntwoord_Antwoord>
Last update: 04-03-2024