Introduction
In this guide we will provide the necessary IT infrastructure requirements for integrating our services (e.g. the Patient, Search and Connect API) in your local software. Adherence to these requirements will ensure an efficient and secure connection between your local system and WMDA’s services.
- Support RESTful APIs
Our services are built around RESTful APIs, which follow standard HTTP protocols. Your local IT infrastructure must be capable of supporting RESTful APIs to ensure successful communication between your systems and our services. This includes support for HTTPS and JSON. - Network configuration: Port TCP/443
To facilitate secure communication with our APIs, your network infrastructure must allow outbound traffic on TCP port 443. This port is used for HTTPS, ensuring that all data exchanged between your systems and our APIs is encrypted and secure
In case your local environment blocks traffic on port TCP/443 by default, you may need to explicitly allow traffic on TCP/443 for the following IP addresses/domains:
- WMDA IP address: 20.76.211.58
ensure that the IP address hosting our services is whitelisted to allow communication
- login.microsoftonline.com
since authentication tokens for our APIs are fetched from Microsoft’s services, you must also allow traffic to the “login.microsoftonline.com” domain. This will ensure that your systems can successfully obtain the necessary tokens for accessing our APIs. - Middleware usage for API connections
We strongly recommend that your local software does not connect directly to our APIs. Instead, you should implement middleware that acts as an intermediary between your local systems and our API services. Using middleware provides an additional layer of security and flexibility, allowing you to implement custom logic and error handling as required. - A local patient management system
The WMDA Search, Match & Connect services are not designed and intended for patient management. To save costs, resources and to minimise the data stored in the WMDA systems, patients are automatically inactivated and archived when they are not actively used. It is therefore imperative that your local system keeps the original records of patients and stores any relevant information obtained in the WMDA Search, Match & Connect services.
For any further questions of information, please contact: support@wmda.info