180 lines
4.6 KiB
Markdown
180 lines
4.6 KiB
Markdown
# DICOM Migration REST API
|
|
|
|
A simple REST API that triggers DICOM study migration for a specific Accession Number.
|
|
|
|
## How to Run
|
|
|
|
```bash
|
|
# Start the server on default port 8000
|
|
python run.py
|
|
|
|
# Custom port
|
|
python run.py --port 9000
|
|
|
|
# Custom token
|
|
python run.py --token your-secure-token
|
|
|
|
# Development mode with auto-reload
|
|
python run.py --reload
|
|
```
|
|
|
|
## How to Use
|
|
|
|
### Make a Request
|
|
|
|
```bash
|
|
# Using curl
|
|
curl -X POST "http://localhost:8000/migrate/R.20240401.0138" \
|
|
-H "Authorization: Bearer token-his2-untuk-hit-api-migrasi-clarity" \
|
|
-H "Content-Type: application/json"
|
|
```
|
|
|
|
### Response Success Example
|
|
|
|
```json
|
|
{
|
|
"success":true,
|
|
"message":"Berhasil migrasi file DICOM Accession Number: R.20240401.0138",
|
|
"details":
|
|
{
|
|
"accession_number":"R.20240401.0138",
|
|
"process_start_time":"2025-07-11 15:27:26",
|
|
"steps_completed":[
|
|
"study_found","study_retrieved","study_sent","log_created","his_api_success","cleanup_success"
|
|
],
|
|
"study_uid":"1.2.826.1.3680043.9.5282.150415.544835.202404010138",
|
|
"patient_id":"00544835",
|
|
"study_description":"A103 - Thorax PA",
|
|
"instances_retrieved":4,
|
|
"files_sent":2,
|
|
"total_files":2,
|
|
"c_store_success":true,
|
|
"series_count":4,
|
|
"his_api_status_code":200,
|
|
"his_integration_success":true,
|
|
"cleanup_success":true,
|
|
"process_end_time":"2025-07-11 15:27:46"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Response Failed Example
|
|
Kalau sudah ada di tabel HIS:
|
|
|
|
```json
|
|
{
|
|
"success":true,
|
|
"message":"Berhasil migrasi file DICOM tetapi gagal update HIS: ERR: Accession No. R.20240401.0142 sudah ada ke table `pacs_order_mwl`!",
|
|
"details":{
|
|
"accession_number":"R.20240401.0142",
|
|
"process_start_time":"2025-07-11 16:05:10",
|
|
"steps_completed":[
|
|
"study_found","study_retrieved","study_sent","log_created","his_api_failed","cleanup_success"
|
|
],
|
|
"study_uid":"1.2.826.1.3680043.9.5282.150415.204342.202404010142",
|
|
"patient_id":"00204342",
|
|
"study_description":"A103 - Thorax PA",
|
|
"instances_retrieved":4,
|
|
"files_sent":2,
|
|
"total_files":2,
|
|
"c_store_success":true,
|
|
"series_count":4,
|
|
"his_api_status_code":406,
|
|
"his_integration_success":false,
|
|
"his_error":"ERR: Accession No. R.20240401.0142 sudah ada ke table `pacs_order_mwl`!","cleanup_success":true,
|
|
"process_end_time":"2025-07-11 16:05:12"
|
|
}
|
|
}
|
|
```
|
|
|
|
|
|
## Logs
|
|
|
|
- Main API logs: `logs/api.log`
|
|
- Process details: `logs/api_process.log`
|
|
|
|
## Simple Workflow
|
|
|
|
1. API receives request with accession number
|
|
2. Finds study UID using C-FIND
|
|
3. Downloads DICOM files using C-GET
|
|
4. Uploads files to destination PACS using C-STORE
|
|
5. Updates HIS system via API call
|
|
6. Cleans up all temporary DICOM files
|
|
7. Returns success/failure response
|
|
|
|
## Troubleshooting Tips
|
|
|
|
- Check PACS connectivity in `config/settings.py`
|
|
- Verify the accession number exists in source PACS
|
|
- Ensure permissions for log directories
|
|
- Check both log files for detailed error messages
|
|
- Verify HIS API connectivity for end-to-end success
|
|
|
|
## Quick Test
|
|
|
|
1. Start the server:
|
|
```bash
|
|
python run.py
|
|
```
|
|
|
|
2. In another terminal, test the root endpoint:
|
|
```bash
|
|
curl http://localhost:8000/
|
|
```
|
|
|
|
3. Test migration with a valid accession number:
|
|
```bash
|
|
curl -X POST "http://localhost:8000/migrate/R.20240401.0138" \
|
|
-H "Authorization: Bearer token-his2-untuk-hit-api-migrasi-clarity"
|
|
```
|
|
|
|
## Deploy Systemd Service
|
|
|
|
1. Create a service file:
|
|
```bash
|
|
sudo nano /etc/systemd/system/api-pydicom-migrasi.service
|
|
```
|
|
2. Add the following content:
|
|
```ini
|
|
[Unit]
|
|
Description=DICOM Migration API Service
|
|
After=network.target
|
|
|
|
[Service]
|
|
User=pacs
|
|
Group=pacs
|
|
WorkingDirectory=/home/pacs/pydicom-migrasi-clarity
|
|
Environment="PATH=/home/pacs/pydicom-migrasi-clarity/venv/bin"
|
|
Environment="API_TOKEN=$2y$05$o1Sfikmwynq76PmuBkJeROpS2WcD.Sh4lgrjohMicnlhBlGAt8UAq"
|
|
ExecStart=/home/pacs/pydicom-migrasi-clarity/venv/bin/python /home/pacs/pydicom-migrasi-clarity/api-app/run.py --host 0.0.0.0 --port 8000
|
|
Restart=on-failure
|
|
RestartSec=5s
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
3. Reload systemd and enable the service:
|
|
```bash
|
|
# Reload the systemd configuration
|
|
sudo systemctl daemon-reload
|
|
|
|
# Enable the service to start on boot
|
|
sudo systemctl enable api-pydicom-migrasi.service
|
|
|
|
# Start the service
|
|
sudo systemctl start api-pydicom-migrasi.service
|
|
|
|
# Check the status
|
|
sudo systemctl status api-pydicom-migrasi.service
|
|
```
|
|
|
|
4. Monitor logs:
|
|
```bash
|
|
# View all logs
|
|
sudo journalctl -u api-pydicom-migrasi.service
|
|
|
|
# Follow logs in real-time
|
|
sudo journalctl -u api-pydicom-migrasi.service -f
|
|
``` |