Toegang tot DICOMweb-API's met de DICOM-service

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

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.

Naast de subset van DICOMweb-API's ondersteunt de DICOM-service twee 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. Gebruik elke programmeertaal die HTTP-aanvragen en -antwoorden ondersteunt om te communiceren met de DICOM-service.

Raadpleeg de voorbeelden voor 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 de zelfstudie DiCOMWeb Standard-API's gebruiken met cURL voor meer informatie over het gebruik van cURL met de DICOM-service™.

Python

Raadpleeg de zelfstudie 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. Informatie over het gebruik van Postman op de Postman-leersite.

Een belangrijke opmerking bij Postman en de DICOMweb Standard is dat Postman alleen ondersteuning biedt voor het uploaden van DICOM-bestanden met behulp van de nettolading met één onderdeel die is gedefinieerd in de DICOM-standaard. Dit komt doordat Postman geen ondersteuning biedt voor aangepaste scheidingstekens in een post-aanvraag met meerdere onderdelen/gerelateerde aanvragen. 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, moet u de verzameling lokaal downloaden en de verzameling importeren via Postman. Zie Voorbeelden van Postman Collection voor toegang tot deze verzameling.

Volgende stappen

Bekijk deze voorbeelden van het gebruik van de API's:

• 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

Meer informatie over Microsoft-ondersteuning voor DICOM Web Standard-API's vindt u in de 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.