• 2Introduction
• 3Request and implement credential
  • 3.1First time request
  • 3.2Implement to Generate Bear Token
  • 3.3Update credential because of expiration
• 4Using the REST API
• 5Upload
• 6Download
  • 6.1Download full dataset

Introduction

Data Manager, previously known as Data Upload, is WMDA's enhanced platform designed for efficient and secure data management within the global donor registry network. Renamed in early 2024, the platform's name change reflects its expanded functionality beyond simple data uploads, accommodating a growing range of data-related features.

Data Manager supports both manual and automatic data uploads, allowing registries to list donor information in the Search & Match Service. Manual uploads involve uploading encrypted XML files, while automatic uploads utilize a REST API for seamless integration between systems. Though XML is currently the primary format, support for JSON files is forthcoming, with notifications to be provided when this becomes available.

Once data is uploaded and processed, it becomes accessible to search coordinators and transplant physicians through the Search & Match Service, and is also integrated into the Match-Connect service. For those using the API, technical support is readily available to ensure smooth operation and understanding.

Data Manager is designed to meet the evolving needs of donor registries, offering robust and real-time data processing capabilities that ensure accurate and up-to-date information is always available. For more information and support, you can contact us directly by emailing support@wmda.info

This document describes the mechanism via the REST API method using curl commands. You can use what programming language you are familiar with to implement the API usage.

Request and implement credential

First time request

If you are not an API user yet, and plan to automate your file handling process. Then please request an API credential from WMDA support team to email support@wmda.info. And please follow steps below:

1. Send email to support@wmda.info with a PGP/GPG public key.  Or if you have other secure way to communicate the credential, please identify that in the email. Below we provide guide how can you generate PGP public key
2. WMDA will provide you the credential and send email to notify you.
3. You test the credential is working and can call  in sandbox system. You can follow the steps below to "Implemented to Generate Bear Token" and  "Using the REST API" to test the credential:
   1. Implement the credential.
   2. Refresh Bear upload user guide below.

Guide to generate PGP/GPG key:

• Use command-line:
  https://www.gnupg.org/gph/en/manual/c14.html

• Use windows based tool Kleopatra
  
  

           - 

Implement to Generate Bear Token

Data Manager uses Bear Token for the authorization as all WMDA API services, please follow user guide for API authentication to implement https://share.wmda.info/x/8I7RFw.

Update credential because of expiration

WMDA API credential is only available for one year currently. If your credential is expired, please send to WMDA support team to request a new one. 
Currently, WMDA is implementing a new feature to let API user to request a new credential by themselves before the credential expires, we will send announcement when this feature is available.

Using the REST API

To get more knowledge for usage of curl, we recommend member to read the doc for curl   https://ec.haxx.se/usingcurl-netrc.html. 

Data Manager API specification is in the swagger doc: https://apispecs.wmda.info/?urls.primaryName=Data%20Manager%20Data%20Exchange%20API

Below is an example to guide how to list ion(s) that you have access:

Step 1: Set up the credential by following the instruction in the "Implement credential" 

Step 2: Test to use the API in WMDA Data Manager sandbox. 
            Below is an example to guide how to get the information to upload a file:

no request body needed

Content-Type

application/json

Step 3:

Run curl call as below to get the ion(s) you have access.  You may get one or multiple ions based on your access permission.
"-i" option can be used to check the detail of the communication if something go wrong.

curl -i https://sandbox-datamanager-api.wmda.info/api/v1/ions/list \
--header 'Authorization: Bearer ••••••' \
--header 'Content-Type: application/json'

Upload

Below is a suggestion for curl call based on the Data Manager swagger doc to upload a file for an ION. 

curl 'https://sandbox-datamanager-api.wmda.info/api/v1/files/upload' \
--header 'Authorization: Bearer ••••••' \
--header 'Content-Type: multipart/form-data'
--form 'file=@c:/path/to/file/ION-0999-D.gpg' \
--form 'ion="9999"' \
--form 'folder="upload"'

Download

Download reports

You may use the API to fetch your reports . And 2 steps are needed. 

1.Fetch the files list and get the file names.

Use the file list API to fetch an array of file list for the folder "report":

curl https://sandbox-datamanager-api.wmda.info/api/v1/files/list \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ••••••' \
--data '{
  "ion": 9999,
  "folder": "report"
}'

2.  Fetch all the reports or the one you need.

Use the file download API to download the file you needed. You can only download one file a time. 

curl https://sandbox-datamanager-api.wmda.info/api/v1/files/download \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ••••••' \
--data '{
  "ion": 9999,
  "folder": "report",
  "fileName": "<filename>.txt"
}'

Download full dataset

For those registries that are permitted to use the full dataset the statement below will fetch that. You can download the file in the folder "download"

curl https://sandbox-datamanager-api.wmda.info/api/v1/files/download \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ••••••' \
--data '{
  "ion": 9999,
  "folder": "download",
  "fileName": "wmda_data_v22.zip.gpg"
}