# پروژه‌ها و کلیدهای DSN

> https://docs.errora.org/account/projects-and-keys

**پروژه** یک برنامه است که می‌خواهید داده‌هایش کنار هم بماند: خطاها، لاگ‌ها، بازپخش‌ها،
مانیتورها، متریک‌ها، پروفایل‌ها و بازخوردهایش.

## ساخت پروژه

**پروژه‌ها ← پروژهٔ جدید**: نام و پلتفرم.

```bash
curl -X POST "$ERRORA/api/v1/organizations/$ORG_ID/projects" \
  -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"Checkout API","platform":"python"}'
```

پلتفرم‌ها: `python`، `php`، `php-laravel`، `node`، `javascript`، `go`، `other`. پلتفرم فقط
آیکون و نمونه‌کد پیشنهادی را تعیین می‌کند.

اسلاگ از روی نام ساخته می‌شود و درون سازمان یکتاست.

### چند پروژه بسازیم؟

به ازای هر سرویس قابل استقرار، یکی. به‌جای پروژهٔ جدا، داخل همان پروژه از **محیط**
(`production`، `staging`) استفاده کنید — فیلترها روی محیط‌ها کار می‌کنند و پروژهٔ staging که
کسی نگاهش نمی‌کند فقط باگ‌ها را پنهان می‌کند.

## کلیدهای DSN

هر پروژه هنگام ساخت یک کلید می‌گیرد:

```text
https://<public_key>@<your-errora-host>/<project_id>
```

- کلیدهای بیشتر (با برچسب) بسازید تا بدون قطعی بچرخانید: DSN جدید را منتشر کنید، منتظر
  جابه‌جایی ترافیک بمانید و بعد کلید قدیمی را غیرفعال کنید.
- غیرفعال‌کردن کلید (`is_active: false`) باعث می‌شود ارسال با آن بی‌درنگ `401` بگیرد.
- کلید عمومی به آن معنا «راز» نیست — SDKهای مرورگری آن را منتشر می‌کنند — ولی هر کسی که آن را
  داشته باشد می‌تواند در پروژهٔ شما رویداد بنویسد. اگر جایی لو رفت که خطر سوءاستفاده دارد،
  بچرخانیدش.

```text
GET  /api/v1/organizations/{org_id}/projects/{project_id}/keys
POST /api/v1/organizations/{org_id}/projects/{project_id}/keys
```

## تنظیمات پروژه

| تنظیم | اثر |
| --- | --- |
| نام / اسلاگ | نمایش و آدرس‌ها |
| پلتفرم | آیکون و نمونه‌کد راه‌اندازی |
| **نرخ نمونه‌برداری** | کسری از رویدادهای *رسیده* که ذخیره می‌شود (`1.0` یعنی همه‌چیز). کنترل هزینه در سمت سرور، مستقل از نمونه‌برداری SDK. |
| **مخزن** | مخزن کد پیوندخورده که [رفع خودکار](/products/ai-autofix) از آن استفاده می‌کند — نگاه کنید به [یکپارچه‌سازی‌ها](/products/integrations) |

```text
GET/PATCH/DELETE /api/v1/organizations/{org_id}/projects/{project_id}
GET              /api/v1/organizations/{org_id}/projects/stats
```

تنظیمات پروژه به توانمندی **`project:manage`** نیاز دارد.

## حذف پروژه

همهٔ رویدادها، خطاها، لاگ‌ها، بازپخش‌ها، مانیتورها، پروفایل‌ها، متریک‌ها و بازخوردهای آن را حذف
می‌کند. بازگشت‌ناپذیر است — هرچه لازم دارید اول خروجی بگیرید.

## عیب‌یابی

| نشانه | علت / راه‌حل |
| --- | --- |
| پاسخ `401` هنگام ارسال داده | کلید عمومی اشتباه است یا غیرفعال شده |
| پاسخ `404` هنگام ارسال داده | شناسهٔ پروژه در مسیر DSN اشتباه است |
| رویداد پذیرفته می‌شود ولی نیست | نرخ نمونه‌برداری کمتر از `1.0` است، یا نگه‌داری داده آن را حذف کرده |
| رویدادها به پروژهٔ اشتباه رفته‌اند | دو DSN در فایل‌های محیطی دارید — ببینید هنگام اجرا کدام بارگذاری می‌شود |