گرفتن لیست کارها

لیست‌ کارها

به منظور دریافت لیست کارها و تاریخچه تغییر وضعیت های اعمال شده به وب سرویس رو‌به‌رو با متد درج شده درکنار آن درخواست ارسال نمایید و با توجه به راهنمای پارامترهای جدول زیر جیسون ارسالی خود را مقداردهی کنید.

به منظور اطلاع در خصوص مقادیر فیلد های task_type و task_status، جدول وضعیت تسک ها و نوع تسک های ذیل را مطالعه بفرمایید.

#	توضیحات	نوع	عنوان فیلد
	تعداد آیتم های جهت نمایش در صفحه	int	count *
	شماره صفحه	int	page *

---

#	توضیحات	نوع	عنوان فیلد
	شناسه تسک	str	id *
	نوع تسک	int	task_type *
	وضعیت تسک	int	task_status *
	تاریخ ایجاد	str	created_at *
	تعداد آیتم ها در صفحه	int	*count
	شماره صفحه	int	page *
	تعداد کل آیتم ها	int	total_count *

وضعیت تسک ها
value	key
ثبت شده	0
در حال بررسی	1
در حال انجام	2
به اتمام رسیده	3
خطا در انجام عملیات	4

نوع تسک ها
value	key
افزودن سفارشات از طریق فایل اکسل	0
تغییر وضعیت(گروهی)	1
خروجی اکسل	2
خروجی پی‌دی‌اف	3
ثبت سفارش(گروهی)	4

https://api.tapin.ir/api/v2/public/task/list/POST

نمونه جیسون جهت ارسال

{
    "count": 2,
    "page": 1
}

نمونه جیسون خروجی

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "id": "e433b239-d961-4efe-98h4-be5e07f1047e",
                "task_type": 0,
                "task_status": 3,
                "created_at": "2020-01-23T22:20:51.996131"
            },
            {
                "id": "d5447909-64e8-444f-bea0-8ea87a338g3f",
                "task_type": 0,
                "task_status": 4,
                "created_at": "2020-01-22T12:30:18.734206"
            }
        ],
        "count": 2,
        "page": 1,
        "total_count": 5
    }
}

.

جزییات کارها

ب منظور دریافت جزییات کارها و تسک ها به وب سرویس رو‌به‌رو با متد درج شده درکنار آن درخواست ارسال نمایید و با توجه task_id دریافتی خود، جیسون ارسالی را مقداردهی کنید.

#	توضیحات	نوع	عنوان فیلد
	شناسه تسک	str	task_id *

---

#	توضیحات	نوع	عنوان فیلد
	شناسه تسک	str	id *
	نوع تسک	int	task_type *
	وضعیت تسک	int	task_status *
	تاریخ ایجاد	str	created_at *
	تاریخ شروع	str	started_at *
	تاریخ پایان	str	ended_at *
	این فیلد مشخص می‌کند که تسک خروجی فایل دارد یا نه	boolean	has_downloadable_file*
	نتیجه تسک (به اعضای هر نوع تسک متفاوت است که در پایین توضیح داده شده است)	list	task_result *

https://api.tapin.ir/api/v2/public/task/detail/POST

نمونه جیسون جهت ارسال

{
    "task_id": "a432b493-d961-3bfs-38m4-gd5z62h0043e"
}

نمونه جیسون خروجی

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "id": "a432b493-d961-3bfs-38m4-gd5z62h0043e",
        "task_type": 0,
        "task_status": 3,
        "created_at": "2020-01-23T22:20:51.996131",
        "started_at": "2020-01-23T22:21:09.479329",
        "ended_at": "2020-01-23T22:21:10.723111",
        "has_downloadable_file": true,
        "task_result": []
    }
}

نتیجه تسک (task_result) توجه به مقادیر مختلف فیلد task_type که در قسمت لیست کارها دریافت کردید، انواع مختلف زیر را خواهد داشت:

task_type=1

[

    {
        "local_id": 4,
        "full_name": "نام و نام خانوادگی ",
        "province": 12,
        "city": 561,
        "message": "شهر مورد نظر یافت نشد.",
        "is_success": false
    },
    {
        "local_id": 5,
        "full_name": "نام و نام خانوادگی",
        "province": 15,
        "city": 561,
        "message": "عملیات با موفقیت انجام شد.",
        "is_success": true
    }
]

task_type=3

[]

task_type=0

[

    {
        "local_id": 4,
        "full_name": "نام و نام خانوادگی ",
        "province": 12,
        "city": 561,
        "message": "شهر مورد نظر یافت نشد.",
        "is_success": false
    },
    {
        "local_id": 5,
        "full_name": "نام و نام خانوادگی",
        "province": 15,
        "city": 561,
        "message": "عملیات با موفقیت انجام شد.",
        "is_success": true
    }
]

task_type=2

[]

task_type=4

[
    {
        "id": "0a7d42db-5e84-48b0-89cc-ea1fd14933c1",
        "full_name": "نام و نام خانوادگی",
        "province": "خوزستان",
        "city": "اروندکنار",
        "message": "عملیات با موفقیت انجام شد.",
        "is_success": true
    }
]