مستندات API

# Request curl -X POST /api/auth/register \ -H 'content-type: application/json' \ -d '{"email": "dr.sara@hospital.com", "password": "secret123"}' # 201 Response { "token": "eyJhbGciOiJIUzI1NiIs...", "user": { "id": 1, "email": "dr.sara@hospital.com", "is_pro": false } } # 409 { "detail": "email_already_registered" } # 422 { "detail": "password_too_short", "min": 6 }

curl -X POST /api/auth/login \ -H 'content-type: application/json' \ -d '{"email": "dr.sara@hospital.com", "password": "secret123"}' # 200 → { "token": "...", "user": { "id": 1, "email": "...", "is_pro": false } } # 401 → { "detail": "invalid_credentials" }

curl /api/usage # با کوکی JWT curl /api/usage -H 'x-anon-token: <uuid>' # ناشناس # 200 { "used": 2, "limit": 3, "is_free": true, "is_pro": false, "unlimited": false, "remaining": 1, "authenticated": false } # برای کاربران Pro: "limit": -1, "unlimited": true, "is_pro": true

curl -X POST /transcribe \ -H 'content-type: application/json' \ -H 'x-anon-token: <uuid>' \ -d '{"text": "كبد چرب گرید يك دارد", "language": "fa"}' # 200 { "transcription": "کبد چرب گرید یک دارد", "engine": "client+normalize" } # 403 { "detail": "free_limit_reached" }

curl -X POST /generate-report \ -H 'content-type: application/json' \ -H 'x-anon-token: <uuid>' \ -d '{ "transcription": "در لوب تحتانی ریه راست نودول 8 میلی متری دیده می شود. افیوژن وجود ندارد.", "modality": "CT", "body_part": "Chest", "clinical_info": "سرفه مزمن" }' # 200 → { "report": { "version": "1.0", "exam": { "modality": "CT", "body_part": "Chest", "exam_date": "2026-01-01T10:00:00.000Z", "language": "fa" }, "clinical_indication": "سرفه مزمن", "technique": "Thin-section axial CT acquisition ...", "comparison": "None available. ...", "findings": [ { "text": "...", "canonical": "nodule", "canonical_fa": "نودول", "severity": null, "laterality": "right", "category": "parenchyma", "abnormal": true } ], "normal_findings": [ "No pleural effusion (بدون افیوژن پلورال)" ], "impression": [ "1. right nodule — نودول سمت راست." ], "recommendations": [ "Clinical correlation recommended. ..." ], "disclaimer": "AI-assisted draft report — ..." } }

curl /api/reports -H 'Authorization: Bearer <token>' # 200 → [ { "id": 12, "title": "CT Chest — نودول ریوی", "modality": "CT", "body_part": "Chest", "transcription": "...", "preview": "...", "created_at": "2026-01-01T10:00:00.000Z" } ]

curl -X POST /api/reports -H 'Authorization: Bearer <token>' \ -H 'content-type: application/json' \ -d '{ "transcription": "...", "report_json": { ... }, "title": "CT Chest — نودول", "modality": "CT", "body_part": "Chest" }' # 201 → گزارش ذخیره‌شده به‌همراه id # 401 → { "detail": "not_authenticated" }

curl /api/reports/12 -H 'Authorization: Bearer <token>' # 200 | 404 curl -X DELETE /api/reports/12 -H 'Authorization: Bearer <token>' # → { "ok": true }

curl -X POST /api/contact -H 'content-type: application/json' \ -d '{"name": "دکتر رضایی", "email": "a@b.com", "message": "درخواست دمو برای بیمارستان"}' # 201 → { "ok": true, "id": 5 }