ATP - ثبتنام کاربر (POST /api/v1/auth/register/)
Endpoint
POST /api/v1/auth/register/
هدف آزمون
ایجاد حساب کاربری جدید.
شرایط آزمون
- سرویس core-api در حال اجرا باشد
- نیازی به احراز هویت نیست
فرآیند آزمون
- ارسال درخواست POST به
/api/v1/auth/register/ - دریافت پاسخ HTTP
- بررسی کد وضعیت و بدنه JSON
معرفی ویژگی
این endpoint عملیات «ثبتنام کاربر» را در API Patent Genie انجام میدهد.
- ورودی معتبر: اعتبارسنجی در مرز API
- پاسخ استاندارد: قالب JSON یکسان با سایر endpointها
- کنترل دسترسی: مطابق policy ماژول مربوطه
سناریوی آزمون
سناریو 1: مسیر موفق
- ارسال
POST /api/v1/auth/register/ - دریافت پاسخ موفق
- بررسی ساختار پاسخ
سناریو 2: خطا - درخواست نامعتبر
- ارسال درخواست با داده یا شناسه نامعتبر
- دریافت کد خطای 4xx
- بررسی پیام خطای استاندارد API
قالب API
| مولفه | نوع | نوع داده | اجباری | توضیحات |
|---|---|---|---|---|
| Body | string | بله | ایمیل یکتا | |
| password | Body | string | بله | رمز قوی |
| full_name | Body | string | بله | نام کامل |
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 برگردانده میشود.
روال صحتسنجی
- بررسی کد وضعیت HTTP
- بررسی فیلد success در بدنه
- بررسی عدم افشای داده حساس
توضیحات
- password در پاسخ نیست