Přístup k rozhraním DICOMweb API pro správu dat DICOM
Služba DICOM® umožňuje ukládat, kontrolovat, vyhledávat a odstraňovat objekty DICOM pomocí podmnožina rozhraní DICOMweb API. Rozhraní API DICOMweb jsou webové služby, které se řídí standardem DICOM. Pomocí těchto rozhraní API můžete přistupovat k datům DICOM vaší organizace a spravovat je bez nutnosti složitých protokolů nebo formátů.
Mezi podporované služby patří:
- Store (STOW-RS): Nahrajte objekty DICOM na server.
- Načtení (WADO-RS): Stáhněte objekty DICOM ze serveru.
- Search (QIDO-RS): Na serveru na základě kritérií najděte objekty DICOM.
- Odstranit: Odeberte objekty DICOM ze serveru.
- Worklist Service (UPS Push and Pull SOPs):: Umožňuje spravovat a sledovat pracovní postupy lékařského zpracování obrazu.
Kromě podmnožiny rozhraní DICOMweb API podporuje služba DICOM tato vlastní rozhraní API, která jsou jedinečná pro Microsoft:
- Kanál změn: Sledování změn dat DICOM v průběhu času
- Rozšířené značky dotazů: Definujte vlastní značky pro dotazování dat DICOM.
- Hromadná aktualizace
- Hromadný import
- Export
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. Pokud chcete pracovat se službou DICOM, použijte libovolný programovací jazyk, který podporuje požadavky a odpovědi HTTP.
Projděte si příklady specifické pro jazyk. Příklady kolekce Postman můžete zobrazit v několika jazycích, včetně následujících.
- 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.
Informace o tom, jak používat cURL se službou DICOM, najdete v tématu Použití rozhraní API DICOMWeb™ Standard s cURL.
Python
Další informace o tom, jak používat Python se službou DICOM, najdete v tématu Použití rozhraní API DICOMWeb™ Standard s Pythonem.
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. Další informace najdete na výukovém webu nástroje Postman.
Jedním z důležitých upozornění u postmanu a standardu DICOMweb je to, ž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, stáhněte ji místně a pak ji naimportujte prostřednictvím nástroje Postman. Pokud chcete získat přístup k kolekci, přečtěte si téma Příklady kolekce Postman.
Další kroky
Použití rozhraní API DICOMweb Standard s jazykem C#
Použití rozhraní API DICOMweb Standard s cURL
Použití standardních rozhraní API DICOMweb s Pythonem
Použití rozhraní DICOMWeb Standard API s ukázkovou kolekcí Postman
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.