Přístup k rozhraním DICOMweb API pomocí služby DICOM

  • Článek

Služba DICOM® umožňuje ukládat, kontrolovat, vyhledávat a odstraňovat objekty DICOM pomocí podmnožina rozhraní DICOMweb API, což jsou webové služby, které se řídí standardem DICOM. Pomocí těchto rozhraní API můžete přistupovat k datům DICOM vaší organizace v cloudu a spravovat je bez nutnosti složitých protokolů nebo formátů.

Mezi podporované služby patří:

Kromě podmnožina rozhraní DICOMweb API podporuje služba DICOM dvě vlastní rozhraní API, která jsou jedinečná pro Microsoft:

Požadavky

  • Nasaďte instanci služby DICOM. Další informace najdete v tématu Nasazení služby DICOM pomocí webu Azure Portal.

  • Vyhledejte adresu URL služby. Pomocí webu Azure Portal přejděte k instanci služby DICOM a vyhledejte adresu URL služby. Adresa URL služby pro přístup ke službě DICOM používá tento formát: https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Při vytváření požadavků nezapomeňte zadat verzi jako součást adresy URL. Další informace najdete v tématu Správa verzí rozhraní API pro službu DICOM.

Použití metod REST API k interakci se službou DICOM

Služba DICOM poskytuje webové rozhraní, které se řídí principy rest (reprezentační přenos stavu). Rozhraní REST API umožňuje vzájemné komunikaci různých aplikací nebo systémů pomocí standardních metod, jako jsou GET, POST, PUT a DELETE. Pro interakci se službou DICOM použijte libovolný programovací jazyk, který podporuje požadavky HTTP a odpovědi.

Příklady specifické pro jazyk najdete v příkladech. Příklady kolekcí Postman můžete zobrazit v několika jazycích, mezi které patří:

  • Přejít
  • Java
  • JavaScript
  • C#
  • PHP
  • C
  • NodeJS
  • Objective-C
  • OCaml
  • PowerShell
  • Python
  • Ruby
  • Swift

C#

Informace o používání jazyka C# se službou DICOM najdete v tématu Použití rozhraní API DICOMweb Standard s jazykem C# .

cURL

cURL je běžný nástroj příkazového řádku pro volání webových koncových bodů a je k dispozici pro většinu operačních systémů. Začněte tím, že si stáhnete cURL.

Pokud se chcete dozvědět, jak používat cURL se službou DICOM, podívejte se na kurz použití rozhraní API diCOMWeb™ Standard s cURL .

Python

V kurzu Použití rozhraní API DICOMWeb™ Standard s Pythonem se dozvíte, jak používat Python se službou DICOM.

Postman

Postman je vynikající nástroj pro navrhování, sestavování a testování rozhraní REST API. Stáhněte si Nástroj Postman , abyste mohli začít. Naučte se používat Nástroj Postman na výukovém webu Postman.

Jednou z důležitých upozornění s Postmanem a DICOMweb Standard je, že Postman podporuje pouze nahrávání souborů DICOM pomocí datové části definované v standardu DICOM. Důvodem je to, že Postman nemůže podporovat vlastní oddělovače v požadavku POST s více částmi nebo souvisejícími. Další informace naleznete v tématu Vícedílný POST nefunguje pro mě # 576. Všechny příklady v kolekci Postman pro nahrání dokumentů DICOM pomocí požadavku s více částmi mají předponu [nebude fungovat – viz popis]. Příklady pro nahrání pomocí požadavku na jednu část jsou součástí kolekce a mají předponu Store-Single-Instance.

Pokud chcete použít kolekci Postman, musíte kolekci stáhnout místně a importovat ji prostřednictvím nástroje Postman. Pokud chcete získat přístup k této kolekci, podívejte se na příklady kolekce Postman.

Další kroky

Podívejte se na tyto příklady použití rozhraní API:

Další informace o podpoře rozhraní API standardu DICOM společnosti Microsoft naleznete v prohlášení o shodě DICOM.

Poznámka:

DICOM® je registrovaná ochranná známka asociace National Electrical Manufacturers Association pro publikace standardů týkající se digitální komunikace s lékařskými informacemi.