از روشهای API زیر برای دریافت جزئیات statusهای تست استفاده کنید.
get_case_statuses #
#
این endpoint به TestRail Enterprise ۷.۳ یا نسخههای جدیدتر نیاز دارد.
فهرستی از statusهای موجود برای test caseها را برمیگرداند.
GET index.php?/api/v2/get_case_statusesمحتوای پاسخ #
پاسخ برگشتی همه statusهای test case را با قالب زیر شامل میشود:
[
{
"case_status_id": 1,
"name": "Approved",
"abbreviation": null,
"is_default": false,
"is_approved": true
},
{
"case_status_id": 2,
"name": "Draft",
"abbreviation": null,
"is_default": true,
"is_approved": false
}
]
فیلدهای زیر در پاسخ برگردانده میشوند:
| نام | نوع | توضیحات |
|---|---|---|
| offset | integer | محل شروع شمارش رکوردها |
| limit | integer | حداکثر تعداد رکوردهایی که برگردانده میشود |
| size | integer | تعداد رکوردهای برگشتی |
| links | object | objectی شامل URIهای مجموعه مقادیر بعدی و قبلی، در صورت وجود |
| case_statuses | object | آرایهای از اطلاعات statusهای test case |
فیلدهای case_status #
| نام | نوع | توضیحات |
|---|---|---|
| case_status_id | integer | ID یکتای status |
| name | string | نام سیستمی status |
| abbreviation | string | برچسب جایگزین برای status |
| is_default | boolean | اگر این status، status پیشفرض test caseها باشد، مقدار true است |
| is_approved | boolean | اگر این status یک status تأییدشده باشد، مقدار true است |
کدهای پاسخ #
| Status Code | توضیحات |
|---|---|
| 200 | موفقیتآمیز (statusهای موجود test case بهعنوان بخشی از پاسخ برگردانده میشوند) |
get_statuses #
فهرستی از statusهای تست موجود را برمیگرداند.
GET index.php?/api/v2/get_statusesمحتوای پاسخ #
پاسخ برگشتی همه statusهای سیستمی و سفارشی را با قالب زیر شامل میشود:
[
{
"color_bright": 12709313,
"color_dark": 6667107,
"color_medium": 9820525,
"id": 1,
"is_final": true,
"is_system": true,
"is_untested": false,
"label": "Passed",
"name": "passed"
},
{
"color_bright": 16631751,
"color_dark": 14250867,
"color_medium": 15829135,
"id": 5,
"is_final": true,
"is_system": true,
"is_untested": false,
"label": "Failed",
"name": "failed"
},
{
"color_bright": 13684944,
"color_dark": 0,
"color_medium": 10526880,
"id": 6,
"is_final": false,
"is_system": false,
"is_untested": false,
"label": "Custom",
"name": "custom_status1"
}
]هر status یک ID یکتا، یک name (نام سیستمی) و یک label (نام نمایشی) دارد. فیلدهای مربوط به رنگ، رنگهای استفادهشده برای status را مشخص میکنند و مقدارشان رنگ RGB است. statusهای سیستمی زیر بهطور پیشفرض در دسترس هستند. میتوانید statusهای سفارشی بیشتری را از مسیر Administration > Customizations در TestRail اضافه کنید.
| ID | نام |
|---|---|
| 1 | Passed |
| 2 | Blocked |
| 3 | Untested |
| 4 | Retest |
| 5 | Failed |
کدهای پاسخ #
| Status Code | توضیحات |
|---|---|
| 200 | موفقیتآمیز (statusهای موجود بهعنوان بخشی از پاسخ برگردانده میشوند) |
