انواع داده‌ها

فرمت‌های تاریخ

API از دو فرمت تاریخ پشتیبانی می‌کند:

فرمت مثال توضیح
Jalali (شمسی) 1403-01-15 فرمت پیش‌فرض برای کاربران ایرانی
Gregorian (میلادی) 2024-04-03 قابل تنظیم در تنظیمات

فرمت پاسخ خطا

تمامی خطاها در قالب زیر برمی‌گردند:

{
  "message": "پیام خطا"
}

کدهای وضعیت HTTP:

کد توضیح
200 موفقیت
201 ایجاد شد
204 بدون محتوا (حذف موفق)
400 درخواست نادرست
401 احراز هویت نشده
403 دسترسی غیرمجاز (forbidden)
404 یافت نشد
422 خطای اعتبارسنجی
429 محدودیت نرخ (rate limit)

صفحه‌بندی (Pagination)

تمامی endpointهای لیست از صفحه‌بندی استفاده می‌کنند:

پارامترهای درخواست:

پارامتر نوع پیش‌فرض توضیح
page integer 1 شماره صفحه
limit integer 20 تعداد رکورد در هر صفحه

ساختار پاسخ:

{
  "records": [...],
  "meta": {
    "total": 150,
    "total_pages": 8,
    "current_page": 1,
    "per_page": 20,
    "from": 1,
    "to": 20
  }
}

نوع رکورد در پاسخ‌ها

بیشتر endpointها یکی از دو الگوی زیر را دنبال می‌کنند:

لیست: { "records": [ ... ], "meta": { ... } } تکی: { "record": { ... } } یا { "data": { ... } }

فیلدهای عمومی

فیلد رکورد

فیلد نوع توضیح
id integer شناسه یکتا
created_at string تاریخ ایجاد
updated_at string آخرین به‌روزرسانی
deleted 0 یا 1 حذف شده یا خیر

فیلد جستجو

بیشتر endpointهای لیست از پارامترهای جستجوی زیر پشتیبانی می‌کنند:

پارامتر نوع توضیح
search string عبارت جستجو
status string فیلتر بر اساس وضعیت
sort string مرتب‌سازی
برای جستجو تایپ کنید...