لیست پروژه‌ها

دریافت لیست پروژه‌ها با قابلیت فیلتر و صفحه‌بندی.

درخواست

Method: GET
URL: /api/projects
Headers: Authorization: Bearer {token}

مثال درخواست

curl -X GET "https://example.com/api/projects" \
  -H "Authorization: Bearer {token}"

پاسخ موفق (200)

{
  "records": [
    {
      "id": 1,
      "title": "پروژه نمونه",
      "description": "توضیحات پروژه",
      "client_id": 1,
      "status": "in_progress",
      "start_date": "1403-01-01",
      "deadline": "1403-06-30",
      "created_at": "1403-01-01"
    }
  ],
  "meta": {
    "total": 10,
    "current_page": 1,
    "per_page": 20
  }
}

خطاها

کد	توضیح
401	توکن معتبر نیست

جزئیات پروژه

دریافت اطلاعات کامل یک پروژه.

درخواست

Method: GET
URL: /api/projects/{id}
Headers: Authorization: Bearer {token}

مثال درخواست

curl -X GET "https://example.com/api/projects/1" \
  -H "Authorization: Bearer {token}"

پاسخ موفق (200)

{
  "record": {
    "id": 1,
    "title": "پروژه نمونه",
    "description": "توضیحات کامل پروژه",
    "client_id": 1,
    "status": "in_progress",
    "start_date": "1403-01-01",
    "deadline": "1403-06-30",
    "price": 50000000,
    "labels": [],
    "created_at": "1403-01-01"
  }
}

خطاها

کد	توضیح
401	توکن معتبر نیست
404	پروژه یافت نشد

ایجاد پروژه جدید

ایجاد یک پروژه جدید در سیستم.

درخواست

Method: POST
URL: /api/projects
Headers: Authorization: Bearer {token}
Content-Type: application/json

مثال درخواست

curl -X POST "https://example.com/api/projects" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "پروژه جدید",
    "description": "توضیحات پروژه",
    "client_id": 1,
    "start_date": "1403-07-01",
    "deadline": "1403-12-30"
  }'

پاسخ موفق (201)

{
  "record": {
    "id": 2,
    "title": "پروژه جدید",
    "client_id": 1,
    "start_date": "1403-07-01",
    "deadline": "1403-12-30"
  }
}

خطاها

کد	توضیح
401	توکن معتبر نیست
422	خطای اعتبارسنجی