انواع دادهها
فرمتهای تاریخ
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 | مرتبسازی |