Uzyskiwanie dostępu do interfejsów API DICOMweb za pomocą usługi DICOM

  • Artykuł

Usługa DICOM® umożliwia przechowywanie, przeglądanie, wyszukiwanie i usuwanie obiektów DICOM przy użyciu podzbioru interfejsów API DICOMweb, które są usługami internetowymi, które są zgodne ze standardem DICOM. Korzystając z tych interfejsów API, możesz uzyskiwać dostęp do danych DICOM organizacji i zarządzać nimi w chmurze bez konieczności używania złożonych protokołów lub formatów.

Obsługiwane usługi to:

Oprócz podzestawu interfejsów API DICOMweb usługa DICOM obsługuje dwa niestandardowe interfejsy API, które są unikatowe dla firmy Microsoft:

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. Użyj dowolnego języka programowania, który obsługuje żądania HTTP i odpowiedzi w celu interakcji z usługą DICOM.

Przykłady specyficzne dla języka można znaleźć w przykładach. Przykłady kolekcji Postman można wyświetlić w kilku językach, w tym:

  • 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 Artykuł Using DICOMWeb Standard APIs with cURL tutorial (Korzystanie z interfejsów API DICOMWeb™ Standard za pomocą biblioteki cURL ).

Python

Zapoznaj się z samouczkiem Using DICOMWeb Standard APIs with Python (Korzystanie z interfejsów API DICOMWeb™ w języku Python w języku Python), aby dowiedzieć się, jak używać języka Python z usługą DICOM.

Postman

Postman to doskonałe narzędzie do projektowania, kompilowania i testowania interfejsów API REST. Pobierz narzędzie Postman , aby rozpocząć pracę. Dowiedz się, jak używać narzędzia Postman w witrynie szkoleniowej Postman.

Jedną z ważnych zastrzeżeń dotyczących narzędzia Postman i standardu DICOMweb jest to, że narzędzie Postman obsługuje tylko przekazywanie plików DICOM przy użyciu ładunku pojedynczej części zdefiniowanego w standardzie DICOM. Przyczyną jest to, że 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, musisz pobrać kolekcję lokalnie i zaimportować kolekcję za pośrednictwem narzędzia Postman. Aby uzyskać dostęp do tej kolekcji, zobacz Przykłady kolekcji Postman.

Następne kroki

Zapoznaj się z poniższymi przykładami używania interfejsów API:

Dowiedz się więcej na temat pomocy technicznej firmy Microsoft dla interfejsów API w standardzie DICOM w instrukcji zgodności diCOM.

Uwaga

DICOM® jest zastrzeżonym znakiem towarowym National Electrical Manufacturers Association for its Standards publikacji odnoszących się do cyfrowej komunikacji informacji medycznych.