DICOMweb-API's openen voor het beheren van DICOM-gegevens

Met de DICOM-service kunt u DICOM-objecten® opslaan, controleren, zoeken en verwijderen met behulp van een subset van DICOMweb-API's. De DICOMweb-API's zijn webservices die voldoen aan de DICOM-standaard. Met deze API's kunt u de DICOM-gegevens van uw organisatie openen en beheren zonder complexe protocollen of indelingen.

De ondersteunde services zijn:

• Store (STOW-RS):Upload DICOM-objecten naar de server.
• Ophalen (WADO-RS):Download DICOM-objecten van de server.
• Zoeken (QIDO-RS):Zoek DICOM-objecten op de server op basis van criteria.
• Verwijderen: DICOM-objecten van de server verwijderen.
• Worklist Service (UPS Push and Pull SOPs): werkstromen voor medische imaging beheren en bijhouden.

Naast de subset van DICOMweb-API's ondersteunt de DICOM-service deze aangepaste API's die uniek zijn voor Microsoft:

• Wijzigingenfeed: Wijzigingen in DICOM-gegevens in de loop van de tijd bijhouden.
• Uitgebreide querytags: aangepaste tags definiëren voor het uitvoeren van query's op DICOM-gegevens.
• Bulksgewijs bijwerken
• Bulkimport
• Export

Vereisten

• Implementeer een exemplaar van de DICOM-service. Zie De DICOM-service implementeren met behulp van Azure Portal voor meer informatie.

• Zoek uw service-URL. Gebruik Azure Portal om naar het exemplaar van de DICOM-service te navigeren om de service-URL te vinden. De service-URL voor toegang tot uw DICOM-service gebruikt deze indeling: https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com. Zorg ervoor dat u de versie opgeeft als onderdeel van de URL bij het indienen van aanvragen. Zie API-versiebeheer voor de DICOM-service voor meer informatie.

REST API-methoden gebruiken om te communiceren met de DICOM-service

De DICOM-service biedt een webinterface die de REST-principes (representational state transfer) volgt. Met de REST API kunnen verschillende toepassingen of systemen met elkaar communiceren met behulp van standaardmethoden zoals GET, POST, PUT en DELETE. Als u wilt communiceren met de DICOM-service, gebruikt u elke programmeertaal die HTTP-aanvragen en -antwoorden ondersteunt.

Raadpleeg de taalspecifieke voorbeelden. U kunt Voorbeelden van Postman-verzamelingen bekijken in verschillende talen, waaronder:

• Go
• Java
• JavaScript
• C#
• PHP
• E
• NodeJS
• Objective-C
• OCaml
• Powershell
• Python
• Ruby
• Swift

C#

Raadpleeg DICOMweb Standard-API's gebruiken met C# voor meer informatie over het gebruik van C# met de DICOM-service.

cURL

cURL is een veelgebruikt opdrachtregelprogramma voor het aanroepen van webeindpunten en is beschikbaar voor de meeste besturingssystemen. Download cURL om aan de slag te gaan.

Zie DICOMWeb™ Standard-API's gebruiken met cURL voor meer informatie over het gebruik van cURL met de DICOM-service.

Python

Zie DICOMWeb™ Standard API's gebruiken met Python voor meer informatie over het gebruik van Python met de DICOM-service.

Postman

Postman is een uitstekend hulpprogramma voor het ontwerpen, bouwen en testen van REST API's. Download Postman om aan de slag te gaan. Zie de Postman-leersite voor meer informatie.

Een belangrijke opmerking bij Postman en de DICOMweb-standaard is dat Postman alleen ondersteuning biedt voor het uploaden van DICOM-bestanden met behulp van de nettolading met één deel die is gedefinieerd in de DICOM-standaard. Dit is omdat Postman geen ondersteuning biedt voor aangepaste scheidingstekens in een POST-aanvraag met meerdere onderdelen. Zie Multipart POST werkt niet voor mij # 576 voor meer informatie. Alle voorbeelden in de Postman-verzameling voor het uploaden van DICOM-documenten met behulp van een aanvraag met meerdere onderdelen worden voorafgegaan door [werkt niet - zie beschrijving]. De voorbeelden voor het uploaden met behulp van een aanvraag met één deel zijn opgenomen in de verzameling en worden voorafgegaan door Store-Single-Instance.

Als u de Postman-verzameling wilt gebruiken, downloadt u deze lokaal en importeert u de verzameling vervolgens via Postman. Zie Voorbeelden van Postman Collection voor toegang tot de verzameling.

Volgende stappen

DICOMweb Standard-API's gebruiken met C#

DICOMweb Standard-API's gebruiken met cURL

DICOMweb Standard-API's gebruiken met Python

DICOMWeb Standard-API's gebruiken met de Postman-voorbeeldverzameling

DICOM Conformance-instructie

Notitie

DICOM® is het gedeponeerde handelsmerk van de National Electrical Manufacturers Association voor haar standaardenpublicaties met betrekking tot digitale communicatie van medische informatie.