Udostępnij za pośrednictwem

Uzyskiwanie dostępu do interfejsów API DICOMweb w celu zarządzania danymi DICOM

  • Artykuł

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:

Oprócz podzestawu interfejsów API DICOMweb usługa DICOM obsługuje te 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. 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:

  • 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 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 z jedną częścią zdefiniowaną w standardzie DICOM. To zastrzeżenie jest spowodowane tym, że narzędzie Postman nie może obsługiwać separatorów niestandardowych w żądaniu POST obejmującym wiele części/powiązanych z nimi żądań 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

Instrukcja zgodności z diCOM

Uwaga

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