از موارد زیر استفاده کنید API روش هایی برای درخواست جزئیات در مورد نتایج تست و افزودن نتایج تست جدید.
دریافت_نتایج #
لیستی از نتایج تست را برای یک آزمایش برمی گرداند.
GET index.php?/api/v2/get_results/{test_id}
پارامترها #
| نام | تایپ کنید | مورد نیاز | توضیحات |
|---|---|---|---|
| test_id | عدد صحیح | درست است | شناسه آزمون |
| محدود کردن | عدد صحیح | نادرست | عددی که محدودیت نتایج آزمون را برای نمایش در پاسخ تعیین می کند (محدودیت اندازه پاسخ به طور پیش فرض ۲۵۰ است) – به TestRail ۶.۷ یا بالاتر نیاز دارد |
| جبران | عدد صحیح | نادرست | عددی که موقعیتی را تعیین می کند که پاسخ باید از آن شروع شود – به TestRail ۶.۷ یا بالاتر نیاز دارد |
این روش تا ۲۵۰ ورودی را در آرایه پاسخ برمی گرداند. برای بازیابی ورودیهای اضافی، میتوانید با استفاده از فیلتر افست که در بخش درخواست فیلترها در زیر توضیح داده شده است، درخواستهای اضافی انجام دهید.
درخواست فیلتر #
فیلترهای زیر را می توان اعمال کرد:
| نام | تایپ کنید | توضیحات |
|---|---|---|
| نقص_فیلتر | رشته | یک شناسه نقص واحد (به عنوان مثال TR-۱، ۴۲۹۱، و غیره) |
| حد / جبران | عدد صحیح | نتیجه را به :limit test محدود کنید. برای رد کردن رکوردها از :offset استفاده کنید |
| status_id | عدد صحیح (فهرست) | فهرستی از شناسههای وضعیت جدا شده با کاما برای فیلتر کردن |
# The latest 10 results for test with ID 1 and statuses 4 or 5 (Retest, Failed)
GET index.php?/api/v2/get_results/1&status_id=4,5&limit=10
محتوای پاسخ #
لطفاً برای پاسخ معمولی زیر را ببینید:
{
"offset": 0,
"limit": 250,
"size": 250,
"_links": {
"next": "/api/v2/get_results/131071&limit=250&offset=250",
"prev": null
},
"results": [
{
"assignedto_id": 1,
"comment": "This test failed: ..",
"created_by": 1,
"created_on": 1393851801,
"custom_step_results": [],
"defects": "TR-1",
"elapsed": "5m",
"id": 1,
"status_id": 5,
"test_id": 1,
"version": "1.0RC1"
}
]
}
فیلدهای سیستم زیر همیشه در پاسخ گنجانده شده است:
| نام | تایپ کنید | توضیحات |
|---|---|---|
| assignedto_id | عدد صحیح | شناسه گیرنده (کاربر) نتیجه آزمون |
| نظر دادن | رشته | نظر یا پیام خطای نتیجه آزمایش |
| ایجاد_توسط | عدد صحیح | شناسه کاربری که نتیجه آزمایش را ایجاد کرده است |
| ایجاد_روشن | مهر زمانی | تاریخ/زمانی که نتیجه آزمایش ایجاد شد (به عنوان مهر زمانی یونیکس) |
| نقص ها | رشته | فهرستی از عیوب جدا شده با کاما که به نتیجه آزمایش مرتبط است |
| گذشت | بازه زمانی | مدت زمانی که برای اجرای آزمایش صرف شد (مثلاً «۱ متر» یا «۲ دقیقه ۳۰ ثانیه») |
| شناسه | عدد صحیح | شناسه منحصر به فرد نتیجه آزمایش |
| status_id | عدد صحیح | وضعیت نتیجه آزمایش، به عنوان مثال. گذشت یا شکست خورد، همچنین ببینید get_statuses |
| test_id | عدد صحیح | شناسه آزمونی که این نتیجه آزمون به آن تعلق دارد |
| نسخه | رشته | نسخه (ساخت) آزمایش بر علیه اجرا شد |
را depth، display_order و parent فیلدها سلسله مراتب بخش ها را در مجموعه آزمایشی تعیین می کنند. را depth فیلد برای همه بخش ها در سطح ریشه ۰ و برای همه بخش های فرزند بزرگتر از ۰ است. را depth فیلد، بنابراین، شبیه سطح در سلسله مراتب بخش است. همچنین، ببینید get_sections برای مثال
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتایج آزمون به عنوان بخشی از پاسخ برگردانده می شود) |
| 400 | تست نامعتبر یا ناشناخته |
| 403 | عدم دسترسی به پروژه |
| 429 | فقط TestRail Cloud– درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |
دریافت_نتایج_برای_مورد #
فهرستی از نتایج تست را برای اجرای تست و ترکیب موردی برمیگرداند.
تفاوت به دریافت_نتایج این است که این روش به جای تست، انتظار اجرای تست + تستکیس را دارد. در TestRail، تستها بخشی از یک اجرای تست و تستکیسها بخشی از مجموعه تست مربوطه هستند. بنابراین، هنگامی که یک اجرای تست جدید ایجاد میکنید، TestRail یک تست برای هر تستکیس موجود در مجموعه آزمایشی اجرا ایجاد میکند. بنابراین، میتوانید یک تست را به عنوان «نمونهای» از یک تستکیس در نظر بگیرید که میتواند نتایج تست، نظرات و وضعیت آزمون را داشته باشد. لطفا TestRail را نیز ببینید راهنمای شروع برای جزئیات بیشتر در مورد تفاوت بین تستکیسها و تست.
GET index.php?/api/v2/get_results_for_case/{run_id}/{case_id}
پارامترها #
| نام | تایپ کنید | مورد نیاز | توضیحات |
|---|---|---|---|
| run_id | عدد صحیح | درست است | شناسه اجرای تست |
| case_id | عدد صحیح | درست است | شناسه پرونده آزمایشی |
این روش تا ۲۵۰ ورودی را در آرایه پاسخ برمی گرداند. برای بازیابی ورودیهای اضافی، میتوانید با استفاده از فیلتر افست که در بخش درخواست فیلترها در زیر توضیح داده شده است، درخواستهای اضافی انجام دهید.
درخواست فیلتر #
فیلترهای زیر را می توان اعمال کرد:
| نام | تایپ کنید | توضیحات |
|---|---|---|
| نقص_فیلتر | رشته | یک شناسه نقص واحد (به عنوان مثال TR-۱، ۴۲۹۱، و غیره) |
| محدود کردن | عدد صحیح | تعداد نتایج تستی که باید پاسخ دهد (اندازه پاسخ به طور پیش فرض ۲۵۰ است) – به TestRail ۶.۷ یا بالاتر نیاز دارد |
| جبران | عدد صحیح | شمارش نتایج آزمون را از کجا شروع کنیم (افست) – به TestRail ۶.۷ یا بالاتر نیاز دارد |
| status_id | عدد صحیح (فهرست) | فهرستی از شناسههای وضعیت جدا شده با کاما برای فیلتر کردن |
# All results for test run with ID 1 and test case with ID 2
GET index.php?/api/v2/get_results_for_case/1/2
محتوای پاسخ #
این روش از همان قالب پاسخ استفاده می کند دریافت_نتایج.
{
"offset": 0,
"limit": 250,
"size": 250,
"_links": {
"next": "/api/v2/get_results/131071&limit=250&offset=250",
"prev": null
},
"results": [
{
"assignedto_id": 1,
"comment": "This test failed: ..",
"created_by": 1,
"created_on": 1393851801,
"custom_step_results": [],
"defects": "TR-1",
"elapsed": "5m",
"id": 1,
"status_id": 5,
"test_id": 1,
"case_id": 5,
"version": "1.0RC1"
}
]
}
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتایج آزمون به عنوان بخشی از پاسخ برگردانده می شود) |
| 400 | اجرای تست یا مورد نامعتبر یا ناشناخته |
| 403 | عدم دسترسی به پروژه |
| 429 | فقط TestRail Cloud– درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |
get_results_for_run #
فهرستی از نتایج تست را برای اجرای تست برمیگرداند.
GET index.php?/api/v2/get_results_for_run/{run_id}
پارامترها #
| نام | تایپ کنید | مورد نیاز | توضیحات |
|---|---|---|---|
| run_id | عدد صحیح | درست است | شناسه اجرای تست |
این روش تا ۲۵۰ ورودی را در آرایه پاسخ برمی گرداند. برای بازیابی ورودیهای اضافی، میتوانید با استفاده از فیلتر افست که در بخش درخواست فیلترها در زیر توضیح داده شده است، درخواستهای اضافی انجام دهید.
درخواست فیلتر #
فیلترهای زیر را می توان اعمال کرد:
| نام | تایپ کنید | توضیحات |
|---|---|---|
| ایجاد_بعد | مهر زمانی | فقط نتایج تست ایجاد شده پس از این تاریخ (به عنوان مهر زمانی یونیکس) را برگردانید |
| ایجاد شده_قبل | مهر زمانی | فقط نتایج تست ایجاد شده قبل از این تاریخ (به عنوان مهر زمانی یونیکس) را برگردانید |
| ایجاد_توسط | عدد صحیح (فهرست) | فهرستی از سازندگان (شناسههای کاربری) جدا شده با کاما برای فیلتر کردن |
| نقص_فیلتر | رشته | یک شناسه نقص واحد (به عنوان مثال TR-۱، ۴۲۹۱، و غیره) |
| محدود کردن | عدد صحیح | عددی که محدودیت نتایج نشان داده شده در پاسخ را تعیین می کند (پارامتر اختیاری. محدودیت اندازه پاسخ به طور پیش فرض ۲۵۰ است) – به TestRail ۶.۷ یا بالاتر نیاز دارد |
| جبران | عدد صحیح | شماره ای که موقعیتی را تعیین می کند که پاسخ باید از آن شروع شود (پارامتر اختیاری) – به TestRail ۶.۷ یا بالاتر نیاز دارد |
| status_id | عدد صحیح (فهرست) | فهرستی از شناسههای وضعیت جدا شده با کاما برای فیلتر کردن |
# The latest 10 results for test run with ID 1 created by user 5
GET index.php?/api/v2/get_results_for_run/1&created_by=5&limit=10
محتوای پاسخ #
لطفاً برای پاسخ معمولی زیر را ببینید:
{
"offset": 0,
"limit": 250,
"size": 250,
"_links": {
"next": "/api/v2/get_results/131071&limit=250&offset=250",
"prev": null
},
"results": [
{
"assignedto_id": 1,
"comment": "This test failed: ..",
"created_by": 1,
"created_on": 1393851801,
"custom_step_results": [],
"defects": "TR-1",
"elapsed": "5m",
"id": 1,
"case_id": 123,
"status_id": 5,
"test_id": 1,
"version": "1.0RC1"
}
]
}
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتایج آزمون به عنوان بخشی از پاسخ برگردانده می شود) |
| 400 | اجرای تست نامعتبر یا ناشناخته |
| 403 | عدم دسترسی به پروژه |
| 429 | فقط TestRail Cloud– درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |
افزودن_نتیجه #
یک نتیجه آزمایش جدید اضافه می کند، نظر می دهد یا آزمایشی را اختصاص می دهد. استفاده از آن توصیه می شود افزودن_نتایج در عوض اگر قصد دارید نتایج را برای چندین آزمایش اضافه کنید.
POST index.php?/api/v2/add_result/{test_id}
| نام | تایپ کنید | توضیحات |
|---|---|---|
| status_id | عدد صحیح |
شناسه وضعیت آزمون وضعیت های پیش فرض سیستم دارای شناسه های زیر هستند:
شما می توانید لیست کاملی از وضعیت های سیستم و سفارشی را از طریق دریافت کنید get_statuses. |
| نظر دادن | رشته | نظر/توضیح برای نتیجه آزمون |
| نسخه | رشته | نسخه یا ساختی که با آن تست کرده اید |
| گذشت | بازه زمانی | زمان لازم برای اجرای آزمایش، به عنوان مثال. «30s» یا «1m 45s» |
| نقص ها | رشته | لیستی از عیوب جدا شده با کاما برای پیوند به نتیجه آزمایش |
| assignedto_id | عدد صحیح | شناسه کاربری که آزمایش باید به آن اختصاص داده شود |
فیلدهای سفارشی نیز پشتیبانی می شوند و باید با نام سیستم خود، با پیشوند ارسال شوند custom_، به عنوان مثال:
{
..
"custom_comment": "This is a custom comment"
..
}
انواع فیلدهای سفارشی زیر پشتیبانی می شوند:
| نام | تایپ کنید | توضیحات |
|---|---|---|
| چک باکس | بولی | درست برای بررسی و نادرست در غیر این صورت |
| تاریخ | رشته | تاریخی با همان قالبی که برای کاربران TestRail و API پیکربندی شده است (مانند «۰۷/۰۸/۲۰۱۳») |
| کشویی | عدد صحیح | شناسه یک مقدار کشویی همانطور که در پیکربندی فیلد پیکربندی شده است |
| عدد صحیح | عدد صحیح | یک عدد صحیح معتبر |
| نقطه عطف | عدد صحیح | شناسه یک نقطه عطف برای فیلد سفارشی |
| چند انتخابی | آرایه | آرایه ای از شناسه ها همانطور که در پیکربندی فیلد پیکربندی شده است |
| نتایج مرحله | آرایه | آرایه ای از اشیاء که نتایج مرحله را مشخص می کند. همچنین مثال زیر را ببینید |
| رشته | رشته | یک رشته معتبر با حداکثر طول ۲۵۰ کاراکتر |
| متن | رشته | رشته ای بدون حداکثر طول |
| URL | رشته | یک رشته با نحو یک URL مطابقت دارد |
| کاربر | عدد صحیح | شناسه یک کاربر برای فیلد سفارشی |
درخواست نمونه #
همچنین مثال زیر را ببینید که نشان می دهد چگونه نتایج مرحله را با فیلد سفارشی مراحل ساخت یافته:
{
"status_id": 5,
"comment": "This test failed",
"elapsed": "15s",
"defects": "TR-7",
"version": "1.0 RC1 build 3724",
"custom_step_results": [
{
"content": "Step 1",
"expected": "Expected Result 1",
"actual": "Actual Result 1",
"status_id": 1
},
{
"content": "Step 2",
"expected": "Expected Result 2",
"actual": "Actual Result 2",
"status_id": 2
}
]
}
محتوای پاسخگویی #
در صورت موفقیت آمیز بودن، این روش نتیجه آزمایش جدید را با استفاده از همان قالب پاسخ باز می گرداند دریافت_نتایج، اما با یک نتیجه به جای لیستی از نتایج.
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتیجه آزمایش ایجاد شد و به عنوان بخشی از پاسخ برگردانده شد) |
| 400 | تست نامعتبر یا ناشناخته |
| 403 | بدون مجوز برای افزودن نتایج تست یا عدم دسترسی به پروژه |
| 429 | فقط TestRail Cloud– درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |
add_result_for_case #
یک نتیجه آزمایش جدید اضافه می کند، نظر می دهد یا آزمایشی را اختصاص می دهد (برای اجرای تست و ترکیب مورد). استفاده از آن توصیه می شود افزودن_نتایج_برای_موارد در عوض اگر قصد دارید نتایج را برای چندین تستکیس اضافه کنید.
تفاوت به افزودن_نتیجه این است که این روش به جای تست، انتظار اجرای تست + تستکیس را دارد. در TestRail، تستها بخشی از یک اجرای تست و تستکیسها بخشی از مجموعه تست مربوطه هستند. بنابراین، هنگامی که یک اجرای تست جدید ایجاد میکنید، TestRail یک تست برای هر تستکیس موجود در مجموعه آزمایشی اجرا ایجاد میکند. بنابراین می توانید یک تست را به عنوان یک “نمونه” از یک تستکیس در نظر بگیرید که می تواند نتایج تست، نظرات و وضعیت آزمون را داشته باشد. لطفا TestRail را نیز ببینید راهنمای شروع برای جزئیات بیشتر در مورد تفاوت بین تستکیسها و تست.
POST index.php?/api/v2/add_result_for_case/{run_id}/{case_id}
پارامترها #
| نام | تایپ کنید | مورد نیاز | توضیحات |
|---|---|---|---|
| run_id | عدد صحیح | درست است | شناسه اجرای تست |
| case_id | عدد صحیح | درست است | شناسه پرونده آزمایشی |
این روش از همان فیلدهای POST پشتیبانی می کند افزودن_نتیجه.
محتوای پاسخگویی #
در صورت موفقیت آمیز بودن، این روش نتیجه آزمایش جدید را با استفاده از همان قالب پاسخ باز می گرداند دریافت_نتایج، اما با یک نتیجه به جای لیستی از نتایج.
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتیجه آزمایش ایجاد شد و به عنوان بخشی از پاسخ برگردانده شد) |
| 400 | اجرای تست یا مورد نامعتبر یا ناشناخته |
| 403 | بدون مجوز برای افزودن نتایج تست یا عدم دسترسی به پروژه |
| 429 | فقط TestRail Cloud– درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |
افزودن_نتایج #
یک یا چند نتیجه آزمایش جدید را اضافه می کند، نظر می دهد یا یک یا چند تست را اختصاص می دهد. ایدهآل برای اتوماسیون تست برای افزودن انبوه چندین نتیجه آزمایش در یک مرحله.
POST index.php?/api/v2/add_results/{run_id}
پارامترها #
| نام | تایپ کنید | مورد نیاز | توضیحات |
|---|---|---|---|
| run_id | عدد صحیح | درست است | شناسه اجرای تست نتایج باید به آن اضافه شود |
این روش انتظار آرایهای از نتایج تست را دارد (از طریق فیلد «نتایج»، لطفاً در زیر ببینید). هر نتیجه آزمون باید شناسه آزمون را مشخص کند و میتواند در همان فیلدهایی که انجام میشود بگذرد افزودن_نتیجه، یعنی تمام سیستم های مربوط به تست و فیلدهای سفارشی.
لطفاً توجه داشته باشید که همه آزمونهای ارجاعشده باید به یک آزمون مشابه تعلق داشته باشند.
درخواست نمونه #
فهرست زیر یک درخواست نمونه معمولی را نشان می دهد. علاوه بر آزمون، باید حداقل یکی از فیلدهای وضعیت، نظر یا واگذارنده را برای هر نتیجه مشخص کنید.
{
"results": [
{
"test_id": 101,
"status_id": 5,
"comment": "This test failed",
"defects": "TR-7"
},
{
"test_id": 102,
"status_id": 1,
"comment": "This test passed",
"elapsed": "5m",
"version": "1.0 RC1"
},
{
"test_id": 101,
"assignedto_id": 5,
"comment": "Assigned this test to Joe"
}
]
}
محتوای پاسخگویی #
در صورت موفقیت آمیز بودن، این روش نتایج تست جدید را با استفاده از همان قالب پاسخ باز می گرداند دریافت_نتایج و به همان ترتیب لیست درخواست.
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتایج آزمون ایجاد شد و به عنوان بخشی از پاسخ برگردانده شد) |
| 400 | اجرای/آزمایش های آزمایشی نامعتبر یا ناشناخته |
| 403 | بدون مجوز برای افزودن نتایج تست یا عدم دسترسی به پروژه |
| 429 | فقط TestRail Cloud– درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |
افزودن_نتایج_برای_موارد #
یک یا چند نتیجه آزمایش جدید را اضافه می کند، نظر می دهد یا یک یا چند آزمایش را اختصاص می دهد (با استفاده از شناسه های موردی). ایدهآل برای اتوماسیون تست برای افزودن انبوه چندین نتیجه آزمایش در یک مرحله.
POST index.php?/api/v2/add_results_for_cases/{run_id}
پارامترها #
| نام | تایپ کنید | مورد نیاز | توضیحات |
|---|---|---|---|
| run_id | عدد صحیح | درست است | شناسه اجرای تست نتایج باید به آن اضافه شود |
این روش انتظار آرایهای از نتایج تست را دارد (از طریق فیلد «نتایج»، لطفاً در زیر ببینید). هر نتیجه آزمون باید شناسه تستکیس را مشخص کند و می تواند در همان فیلدهایی بگذرد افزودن_نتیجه، یعنی تمام سیستم های مربوط به تست و فیلدهای سفارشی.
تفاوت با add_results این است که این روش به جای شناسه های آزمایشی، شناسه های تستکیس را انتظار دارد. لطفا ببینید add_result_for_case برای جزئیات
لطفاً توجه داشته باشید که همه آزمونهای ارجاعشده باید به یک آزمون مشابه تعلق داشته باشند.
درخواست نمونه #
فهرست زیر یک درخواست نمونه معمولی را نشان می دهد. علاوه بر تستکیس، باید حداقل یکی از فیلدهای وضعیت، نظر یا واگذارنده را برای هر نتیجه مشخص کنید.
{
"results": [
{
"case_id": 1,
"status_id": 5,
"comment": "This test failed",
"defects": "TR-7"
},
{
"case_id": 2,
"status_id": 1,
"comment": "This test passed",
"elapsed": "5m",
"version": "1.0 RC1"
},
{
"case_id": 1,
"assignedto_id": 5,
"comment": "Assigned this test to Joe"
}
]
}
محتوای پاسخگویی #
در صورت موفقیت آمیز بودن، این روش یک لیست صفحه بندی نشده از نتایج تست جدید را با استفاده از قالبی مشابه برمی گرداند دریافت_نتایج.
[
{
"assignedto_id": 1,
"comment": "This test failed: ..",
"created_by": 1,
"created_on": 1393851801,
"custom_step_results": [],
"defects": "TR-1",
"elapsed": "5m",
"id": 1,
"status_id": 5,
"test_id": 1,
"version": "1.0RC1"
}
]
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتایج آزمون ایجاد شد و به عنوان بخشی از پاسخ برگردانده شد) |
| 400 | اجرا/تستکیسها نامعتبر یا ناشناخته |
| 403 | بدون مجوز برای افزودن نتایج تست یا عدم دسترسی به پروژه |
| 429 | فقط TestRail Cloud– درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |
edit_result #
نتیجه آزمایش موجود را به روز می کند. از به روز رسانی های جزئی پشتیبانی می کند – فقط فیلدهای موجود در درخواست تغییر می کنند، همه فیلدهای دیگر مقادیر فعلی خود را حفظ می کنند. توصیه می شود زمانی که نیاز به تصحیح یا غنی سازی نتیجه ای دارید که قبلاً ارسال شده است (به عنوان مثال اضافه کردن نتایج مرحله سفارشی یا به روز رسانی یک نظر پس از ارسال اولیه) از این روش استفاده کنید.
POST index.php?/api/v2/edit_result/{result_id}
پارامترها #
| نام | تایپ کنید | مورد نیاز | توضیحات |
|---|---|---|---|
|
result_id
|
عدد صحیح | درست است | شناسه نتیجه آزمون به روز می شود |
درخواست بدن #
فیلترهای زیر را می توان به عنوان پارامترهای پرس و جو در URL درخواست اعمال کرد:
| نام | تایپ کنید | توضیحات |
|---|---|---|
|
status_id
|
بولی | شناسه وضعیت آزمون وضعیت های پیش فرض سیستم دارای شناسه های زیر هستند: ۱: پاس شده; ۲: مسدود شده است. ۳: تست نشده (مجاز نیست). ۴: تست مجدد ۵: شکست خورد. شما می توانید لیست کاملی از وضعیت های سیستم و سفارشی را از طریق get_statuses دریافت کنید. |
|
نظر دادن
|
رشته |
نظر/توضیح برای نتیجه آزمون
|
|
نسخه
|
رشته |
نسخه یا ساختی که با آن تست کرده اید
|
|
گذشت
|
بازه زمانی |
زمان لازم برای اجرای آزمایش، به عنوان مثال. “30s” یا “1m 45s”
|
| نقص ها | رشته |
لیستی از عیوب جدا شده با کاما برای پیوند به نتیجه آزمایش
|
|
assignedto_id
|
عدد صحیح |
شناسه کاربری که آزمایش باید به آن اختصاص داده شود
|
| نام | تایپ کنید | توضیحات |
|---|---|---|
|
چک باکس
|
بولی | درست برای بررسی و نادرست در غیر این صورت |
| تاریخ | رشته |
تاریخی با همان قالبی که برای کاربران TestRail و API پیکربندی شده است (مثلاً “۰۷/۰۸/۲۰۱۳”)
|
| کشویی | عدد صحیح |
شناسه یک مقدار کشویی همانطور که در پیکربندی فیلد پیکربندی شده است
|
| عدد صحیح | عدد صحیح |
یک عدد صحیح معتبر
|
| نقطه عطف | عدد صحیح |
شناسه یک نقطه عطف برای فیلد سفارشی
|
| چند انتخابی | آرایه |
آرایه ای از شناسه ها همانطور که در پیکربندی فیلد پیکربندی شده است
|
| نتایج مرحله | آرایه |
آرایه ای از اشیاء که نتایج مرحله را مشخص می کند. همچنین مثال زیر را ببینید
|
| رشته | رشته |
یک رشته معتبر با حداکثر طول ۲۵۰ کاراکتر
|
| متن | رشته |
رشته ای بدون حداکثر طول
|
| URL | رشته |
یک رشته با نحو یک URL مطابقت دارد
|
| کاربر | عدد صحیح |
شناسه یک کاربر برای فیلد سفارشی
|
درخواست نمونه #
{
"status_id": 5,
"comment": "This test failed",
"elapsed": "15s",
"defects": "TR-7",
"version": "1.0 RC1 build 3724",
"custom_step_results": [
{
"content": "Step 1",
"expected": "Expected Result 1",
"actual": "Actual Result 1",
"status_id": 1
},
{
"content": "Step 2",
"expected": "Expected Result 2",
"actual": "Actual Result 2",
"status_id": 2
}
]
}
محتوای پاسخگویی #
کدهای پاسخگویی #
| کد وضعیت | توضیحات |
|---|---|
| 200 | موفقیت آمیز (نتیجه آزمون به روز شد و به عنوان بخشی از پاسخ برگردانده شد) |
| 400 | نتیجه یا درخواست نامعتبر یا ناشناخته شامل یک فیلد تغییرناپذیر است (id، test_id، create_on، create_by) |
| 403 | بدون مجوز برای ویرایش نتایج تست، بدون دسترسی به پروژه، یا نتیجه خارج از پنجره زمان ویرایش مجاز است |
| 429 | فقط TestRail Cloud – درخواست های بسیار زیاد (نگاه کنید به محدودیت نرخ API) |

