Bricks Switchboard version 2.0

The XML-based version of Bricks Switchboard (version 1.0) has been upgraded to version 2.0, which now uses a modern JSON-based format.

Please contact Tetra B.V. to begin the upgrade process and take advantage of the latest features in Bricks Switchboard.

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-06-2025 12:42