ATP - ثبت‌نام کاربر (POST /api/v1/auth/register/)

Endpoint

POST /api/v1/auth/register/

هدف آزمون

ایجاد حساب کاربری جدید.

شرایط آزمون

• سرویس core-api در حال اجرا باشد
• نیازی به احراز هویت نیست

فرآیند آزمون

1. ارسال درخواست POST به /api/v1/auth/register/
2. دریافت پاسخ HTTP
3. بررسی کد وضعیت و بدنه JSON

معرفی ویژگی

این endpoint عملیات «ثبت‌نام کاربر» را در API Patent Genie انجام می‌دهد.

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

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

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

1. ارسال POST /api/v1/auth/register/
2. دریافت پاسخ موفق
3. بررسی ساختار پاسخ

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

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

سناریو 3: خطا — متد پشتیبانی‌نشده

1. ارسال متدی غیر از POST به همان مسیر
2. دریافت کد 405 Method Not Allowed

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

1. ارسال بدنه یا query نامعتبر
2. دریافت کد 400
3. بررسی پیام خطای validation

قالب API

Swagger

post:
  summary: ثبت‌نام کاربر
  responses:
    201:
      description: منبع ایجاد شد
    400:
      description: داده ورودی نامعتبر
    401:
      description: احراز هویت نامعتبر

نمونه ورودی

curl -X POST "http://localhost:8000/api/v1/auth/register/" -H "Content-Type: application/json" -d '{"email":"user@example.com","password":"StrongPassword123!","full_name":"Example User"}'

نمونه خروجی

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

Status Codes

• 201: کاربر ایجاد شد
• 400: validation
• 409: ایمیل تکراری

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

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

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

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

توضیحات

• password در پاسخ نیست
• پس از ثبت‌نام از login برای دریافت JWT استفاده کنید