Info |
---|
Page Under Development |
This page explains how to use the APIs to:
Find the API call time.
Check connection to OpenClinicaOC.
Verify API based authentication
Why run these APIs?
When the 'OpenClinica Study Data Importer' job takes time (20-30 minutes), it becomes difficult to test the configuration and run the job to sync in the data.
...
Expand |
---|
|
Code Block |
---|
curl -X POST \
--data '{"username": "demo_username", "password": "demo_password"}' \
-H "Content-Type: application/json" \
https://qlhc2.build.openclinica.io/user-service/api/oauth/token |
In above code, ‘POST’ and ‘Content-Type’ will remain fixed. Code that will vary Server credentials: Username and password Server URL: https://qlhc2.build.openclinica.io will be your OpenClinica OC server URL https://qlhc2.build.openclinica.io : This URL comprises 4 parts, i.e., protocol, hostname, port, and path.
Protocol: Decides language used for communication between the client and the server. Hostname: Server placement. Port number: It’s a communication endpoint. It's optional. When not specified, the protocol defined standard port is used. For https, it is 443. For http, it is 80. Optional; default 443 for HTTPS; 80 for HTTP Path: Decides the location of the resource. When not specified, it is /
After invoking auth API, you will receive a token, as shown below. Info |
---|
Every time, you will get a new token when you run the auth API. |
|
...
Expand |
---|
|
Code Block |
---|
curl -X GET -H "Accept: application/xml" \
-H "Authorization: Bearer #1step_token" \
"https://qlhc2.openclinica.io/OpenClinica/pages/auth/api/clinicaldata/S_ISPY(TEST)/*/*/*?includeAudits=y&includeDNs=n&includeMedtadata=y&showArchived=n" |
In the above code, the 'GET' and 'Authorization' will remain fixed. Code that will vary Token: #1step_token token from #1 step Server URL: https://qlhc2.build.openclinica.io OpenClinica OC server URL Study Name: S_ISPY(TEST) study OID from the OpenClinicaOC. After Invoking data API, you will know how much time it takes to download study data. |
...