ATP - استریم گفتگو (GET /api/v1/conversations/{conversation_id}/stream/)

Endpoint

GET /api/v1/conversations/{conversation_id}/stream/

هدف آزمون

دریافت token-stream پاسخ assistant برای یک turn.

شرایط آزمون

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

فرآیند آزمون

1. ارسال درخواست GET به /api/v1/conversations/{conversation_id}/stream/
2. دریافت پاسخ HTTP
3. بررسی کد وضعیت و بدنه JSON

معرفی ویژگی

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

• ورودی معتبر: اعتبارسنجی در مرز API
• پاسخ استاندارد: قالب JSON یکسان با سایر endpointها
• کنترل دسترسی: مطابق policy ماژول مربوطه

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

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

1. ارسال GET /api/v1/conversations/{conversation_id}/stream/
2. دریافت پاسخ موفق
3. بررسی ساختار پاسخ

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

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

سناریو 3: استریم کامل turn

1. create conversation
2. curl -N stream با turn_id
3. دریافت token events
4. دریافت done

سناریو 4: خطا — turn_id الزامی

1. GET stream بدون turn_id
2. 400
3. بررسی "This query parameter is required"

قالب API

Swagger

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

نمونه ورودی

curl -N "http://localhost:8000/api/v1/conversations/{conversation_id}/stream/?turn_id=1" \
  -H "Authorization: Bearer <access>" \
  -H "Accept: text/event-stream"

نمونه خروجی

id: 1
data: {"type":"token","content":"Based"}

id: 2
data: {"type":"token","content":" on"}

id: done
data: {"type":"done","recommendations":[]}

Status Codes

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

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

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

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

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

توضیحات

• Content-Type: text/event-stream
• Cache-Control: no-cache
• turn_id الزامی است