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 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.
- 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 de volgende.
- 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 waarschuwing bij Postman en de DICOMweb-standaard is dat Postman alleen ondersteuning biedt voor het uploaden van DICOM-bestanden met behulp van de nettolading van één deel 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, downloadt u deze lokaal en importeert u de verzameling vervolgens via Postman.
Volgende stappen
DICOMweb Standard-API's gebruiken met C#
DICOMweb Standard-API's gebruiken met cURL
DICOMweb Standard-API's gebruiken met Python
Notitie
DICOM® is het gedeponeerde handelsmerk van de National Electrical Manufacturers Association voor haar standaardenpublicaties met betrekking tot digitale communicatie van medische informatie.