ATP - دانلود گزارش (GET /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/report/download/)

Endpoint

GET /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/report/download/

هدف آزمون

دانلود فایل markdown با Content-Disposition.

شرایط آزمون

• سرویس core-api در حال اجرا باشد
• هدر Authorization با access token معتبر

فرآیند آزمون

1. ارسال درخواست GET به /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/report/download/
2. دریافت پاسخ HTTP
3. بررسی کد وضعیت و بدنه JSON

معرفی ویژگی

این endpoint عملیات «دانلود گزارش» را در API Patent Genie انجام می‌دهد.

• Content-Type: text/markdown; charset=utf-8
• filename: prior-art-report-{run_id}.md

سناریوی آزمون

سناریو 1: مسیر موفق

1. ارسال GET /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/report/download/
2. دریافت پاسخ موفق
3. بررسی ساختار پاسخ

سناریو 2: خطا - درخواست نامعتبر

1. ارسال درخواست با داده یا شناسه نامعتبر
2. دریافت کد خطای 4xx
3. بررسی پیام خطای استاندارد API

سناریو 3: خطا — بدون احراز هویت

1. ارسال درخواست بدون هدر Authorization
2. دریافت کد 401
3. بررسی عدم برگرداندن داده محافظت‌شده

سناریو 4: خطا — منبع یافت نشد

1. استفاده از UUID نامعتبر یا متعلق به کاربر دیگر
2. دریافت کد 404
3. بررسی پیام خطای استاندارد API

قالب API

Swagger

get:
  summary: دانلود گزارش
  responses:
    200:
      description: عملیات موفق
    401:
      description: احراز هویت نامعتبر یا ناقص

نمونه ورودی

curl -X GET "http://localhost:8000/api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/report/download/" \
  -H "Authorization: Bearer <access>" \
  -H "Content-Type: application/json"

نمونه خروجی

{
  "success": true,
  "data": {}
}

Status Codes

• 200: عملیات موفق
• 401: احراز هویت نامعتبر یا ناقص

نتیجه مورد انتظار

در صورت موفقیت، پاسخ JSON استاندارد با کد وضعیت مناسب برای GET برگردانده می‌شود.

روال صحت‌سنجی

1. بررسی کد وضعیت HTTP
2. بررسی فیلد success در بدنه
3. بررسی عدم افشای داده حساس

توضیحات

• برای نمایش inline از endpoint report استفاده کنید