custom url protocol

I have a question:

Can Orthanc be launched from a web browser using a custom url protocol like slicer://, weasis:// or horos:// ?

I am trying to launch orthanc and retrieve a study using wado-uri like I do with osirix: osirix://?methodName=downloadURL&URL=‘http://www.myserver.com/dicomfile.dcm

DJ

Hi,

No, custom url protocol is not supported in Orthanc right now.

Best regards,

Alain

Orthanc is a Web server with a Web interface and a REST API, so there is no need for a URL scheme like “slicer://” or “weasis://”. You just have to use the standard HTTP/HTTPS protocol, like in: “http://localhost:8042/”.

If you want to download a ZIP archive containing a study, you could for instance use:

$ curl https://demo.orthanc-server.com/studies/6c65289b-db2fcb71-7eaf73f4-8e12470c-a4d6d7cf/archive > /tmp/a.zip

The reference of the REST API can be found at the following locations:
https://book.orthanc-server.com/users/rest.html
https://api.orthanc-server.com/

Sébastien-

Thank you for your reply.

I think I didn’t explain my use case well enough:

What I want to do is use a link in my browser to control a local instance of orthanc to retrieve a study from a remote server (or simply to download a dicom file from an URL). In other words I want to download DICOM files by URL into my local orthanc instance from any remote server.

Is that possible using the Othanc API?

DJ-

Yes, it’s possible, but depending on the api of your remote server. One case possible in Orthanc ecosystem is the Query/ Retrieve function. When you click the Query/Retrieve button, it means you call an api from Orthanc to perform C-Get/ C-Move dicom from remote server to your Orthanc. Another case is Transfer Accelerator Plugin (https://book.orthanc-server.com/plugins/transfers.html), if you are using Pull mode, you call an api from your local Orthanc to a remote Orthanc to download the instance/ series/ study. Besides those case, you can create a plugin (by C++ or Python) to customize api calling to your remote Server and then upload them to your local server.
11.png

What I want to do is use a link in my browser to control a local instance of orthanc to retrieve a study from a remote server (or simply to download a dicom file from an URL). In other words I want to download DICOM files by URL into my local orthanc instance from any remote server. Is that possible using the Othanc API?

Yes, check out the reference:
https://book.orthanc-server.com/users/rest.html#performing-query-retrieve-c-find-and-find-with-rest
https://api.orthanc-server.com/#tag/Networking/paths/~1modalities~1{id}~1move/post

Sébastien-