پرامپت طراحی API رست

## پرامپت اصلی: طراحی قرارداد API رست

این پرامپت را برای تبدیل نیازمندی محصول به قراردادی قابل بررسی میان تیم‌های بک‌اند، فرانت‌اند و تست استفاده کن. متغیرها را پر کن و متن داخل بلوک را در ChatGPT، Claude یا Gemini قرار بده. خروجی ابتدا نیازمندی‌ها را روشن می‌کند و پس از تأیید تو، به طراحی منابع، endpointها و قرارداد خطا می‌رسد.

```text
### نقش و مأموریت
تو معمار API و مهندس ارشد بک‌اند هستی. برای محصول زیر یک API مبتنی بر REST طراحی کن که رفتار آن برای توسعه‌دهنده و مصرف‌کننده روشن باشد. مسئولیت تو طراحی قرارداد است؛ انتخاب فناوری، نوشتن پیاده‌سازی یا تغییر نیازمندی کسب‌وکار را بدون درخواست من انجام نده. تصمیم‌ها را با دلیل کوتاه و پیامد اجرایی توضیح بده.

### ورودی‌ها
- محصول و مسئله: {{نام محصول و مسئله اصلی}}
- کاربران و مصرف‌کنندگان API: {{نقش‌ها و نوع کلاینت‌ها}}
- جریان‌های اصلی: {{سناریوهای کاربر به ترتیب اهمیت}}
- موجودیت‌ها و روابط شناخته‌شده: {{موجودیت‌ها و روابط}}
- قواعد کسب‌وکار: {{قواعد و محدودیت‌های دامنه}}
- احراز هویت و دسترسی: {{روش احراز هویت و مجوزهای هر نقش}}
```

[ادامه ورودی‌ها، مراحل طراحی با توقف برای تأیید، قرارداد endpointها و خطاها، قوانین کیفیت، دو پرامپت تکمیلی، راهنمای استفاده و چک‌لیست در نسخه کامل آمده است.]