Uzyskiwanie dostępu do interfejsów API DICOMweb w celu zarządzania danymi DICOM
Usługa DICOM® umożliwia przechowywanie, przeglądanie, wyszukiwanie i usuwanie obiektów DICOM przy użyciu podzbioru interfejsów API DICOMweb. Interfejsy API DICOMweb to usługi internetowe zgodne ze standardem DICOM. Korzystając z tych interfejsów API, możesz uzyskiwać dostęp do danych DICOM organizacji i zarządzać nimi bez konieczności używania złożonych protokołów lub formatów.
Obsługiwane usługi to:
- Store (STOW-RS): Przekazywanie obiektów DICOM do serwera.
- Pobierz (WADO-RS): pobierz obiekty DICOM z serwera.
- Wyszukiwanie (QIDO-RS): znajdowanie obiektów DICOM na serwerze na podstawie kryteriów.
- Usuń: Usuń obiekty DICOM z serwera.
- Usługa listy roboczej (UPS Push and Pull SOPs): zarządzanie przepływami pracy obrazowania medycznego i śledzenie ich.
Oprócz podzestawu interfejsów API DICOMweb usługa DICOM obsługuje te niestandardowe interfejsy API, które są unikatowe dla firmy Microsoft:
- Zestawienie zmian: śledzenie zmian w danych DICOM w czasie.
- Rozszerzone tagi zapytań: zdefiniuj tagi niestandardowe na potrzeby wykonywania zapytań dotyczących danych DICOM.
- Aktualizacja zbiorcza
- Importowanie zbiorcze
- Eksportowanie
Wymagania wstępne
Wdróż wystąpienie usługi DICOM. Aby uzyskać więcej informacji, zobacz Wdrażanie usługi DICOM przy użyciu witryny Azure Portal.
Znajdź adres URL usługi. Użyj witryny Azure Portal, aby przejść do wystąpienia usługi DICOM, aby znaleźć adres URL usługi. Adres URL usługi w celu uzyskania dostępu do usługi DICOM używa następującego formatu:
https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Pamiętaj, aby określić wersję jako część adresu URL podczas tworzenia żądań. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji interfejsu API dla usługi DICOM.
Korzystanie z metod interfejsu API REST do interakcji z usługą DICOM
Usługa DICOM udostępnia internetowy interfejs, który jest zgodny z zasadami REST (transfer stanu reprezentacji). Interfejs API REST umożliwia różnym aplikacjom lub systemom komunikowanie się ze sobą przy użyciu standardowych metod, takich jak GET, POST, PUT i DELETE. Aby wchodzić w interakcje z usługą DICOM, użyj dowolnego języka programowania obsługującego żądania HTTP i odpowiedzi.
Zapoznaj się z przykładami specyficznymi dla języka. Przykłady kolekcji Postman można wyświetlić w kilku językach, w tym w następujących językach.
- Przejdź
- Java
- JavaScript
- C#
- PHP
- C
- NodeJS
- Objective-C
- OCaml
- PowerShell
- Python
- Ruby
- Swift
C#
Zapoznaj się z tematem Używanie interfejsów API DICOMweb Standard z językiem C# , aby dowiedzieć się, jak używać języka C# z usługą DICOM.
cURL
cURL to typowe narzędzie wiersza polecenia do wywoływania internetowych punktów końcowych i jest dostępne dla większości systemów operacyjnych. Aby rozpocząć, pobierz plik cURL.
Aby dowiedzieć się, jak używać biblioteki cURL z usługą DICOM, zobacz Using DICOMWeb Standard APIs with cURL (Używanie interfejsów API DICOMWeb™ Standard z biblioteką cURL).
Python
Aby uzyskać więcej informacji na temat używania języka Python z usługą DICOM, zobacz Using DICOMWeb Standard APIs with Python (Używanie interfejsów API DICOMWeb™ Standard z językiem Python).
Postman
Postman to doskonałe narzędzie do projektowania, kompilowania i testowania interfejsów API REST. Pobierz narzędzie Postman , aby rozpocząć pracę. Aby uzyskać więcej informacji, zobacz witrynę szkoleniową Postman.
Jedną z ważnych ostrożności w przypadku narzędzia Postman i standardu DICOMweb jest to, że narzędzie Postman obsługuje tylko przekazywanie plików DICOM przy użyciu ładunku z jedną częścią zdefiniowaną w standardzie DICOM. Dzieje się tak, ponieważ narzędzie Postman nie może obsługiwać separatorów niestandardowych w wieloczęściowym/powiązanym żądaniu POST. Aby uzyskać więcej informacji, zobacz Multipart POST not working for me # 576 (Multipart POST not working for me # 576). Wszystkie przykłady w kolekcji Postman do przekazywania dokumentów DICOM przy użyciu żądania wieloczęściowego są poprzedzone prefiksem [nie będzie działać — zobacz opis]. Przykłady przekazywania przy użyciu żądania jednoczęściowego znajdują się w kolekcji i są poprzedzone prefiksem Store-Single-Instance.
Aby użyć kolekcji Postman, pobierz ją lokalnie, a następnie zaimportuj kolekcję za pośrednictwem narzędzia Postman. Aby uzyskać dostęp do kolekcji, zobacz Przykłady kolekcji Postman.
Następne kroki
Używanie interfejsów API DICOMweb Standard z językiem C#
Używanie interfejsów API DICOMweb Standard z biblioteką cURL
Używanie interfejsów API DICOMweb Standard z językiem Python
Używanie interfejsów API DICOMWeb Standard z przykładową kolekcją Postman
Uwaga
DICOM® jest zastrzeżonym znakiem towarowym National Electrical Manufacturers Association for its Standards publikacji odnoszących się do cyfrowej komunikacji informacji medycznych.