پیوست‌ها

از روش‌های API زیر برای آپلود، دریافت و حذف پیوست‌ها استفاده کنید.

هنگام آپلود پیوست‌ها از طریق TestRail API با requestهای POST، باید از headerهای زیر استفاده کنید:

Content-Type: multipart/form-data

پیوست باید به‌صورت form data در بدنه request ارسال شود. برای نمونه‌های ارسال پیوست، مستندات دسترسی به API یا bindingهای TestRail را ببینید.

add_attachment_to_case #

یک پیوست به test case اضافه می‌کند. حداکثر اندازه مجاز آپلود 256MB است.

POST index.php?/api/v2/add_attachment_to_case/{case_id}

Parameterها #

{
    "attachment_id": 443
}

POST index.php?/api/v2/add_attachment_to_plan/{plan_id}

{
    "attachment_id": 443
}

POST index.php?/api/v2/add_attachment_to_plan_entry/{plan_id}/{entry_id}

{
    "attachment_id": 443
}

POST index.php?/api/v2/add_attachment_to_result/{result_id}

{
    "attachment_id": 443
}

POST index.php?/api/v2/add_attachment_to_run/{run_id}

{
    "attachment_id": 443
}

GET index.php?/api/v2/get_attachments_for_case/{case_id}&limit={limit}&offset={offset}

{
    "offset": 0,
    "limit": 250,
    "size": 0,
    "_link": {
        "next": null,
        "prev": null,
    },
    "attachments": [
        {
            "id": 1773,
            "name": "image.jpg",
            "size": 21995,
            "created_on": 1585560521,
            "project_id": 33,
            "case_id": 57333,
            "user_id": 1,
            "result_id": null
        }
    ]
}

{
    "offset": 0,
    "limit": 250,
    "size": 4,
    "_links": {
        "next": null,
        "prev": null
    },
    "attachments": [
        {
            "client_id": 614308,
            "project_id": 2,
            "entity_type": "case",
            "id": "2ec27be4-812f-4806-9a5d-d39130d1691a",
            "created_on": 1631722975,
            "data_id": "63c82867-526d-43be-b1a5-9ddfcf581cf5",
            "entity_id": "3",
            "filename": "msdia80.dll",
            "filetype": "dll",
            "legacy_id": 0,
            "name": "msdia80.dll",
            "size": 904704,
            "user_id": 1,
            "is_image": false,
            "icon": "other"
        }
    ]
}

GET index.php?/api/v2/get_attachments_for_plan/{plan_id}&limit={limit}&offset={offset}

Parameterها #

فیلترهای request #

می‌توانید فیلترهای زیر را اعمال کنید:

[
    {
        "id": 1900,
        "name": "TR-2104.gif",
        "size": 3838070,
        "created_on": 1602178189,
        "project_id": 15,
        "case_id": null,
        "user_id": 1,
        "entity_attachments_id": 360,
        "icon_name": "Gif Image",
        "result_id": null
    }
]

get_attachments_for_plan_entry #

فهرست پیوست‌های entry یک test plan را برمی‌گرداند.

GET index.php?/api/v2/get_attachments_for_plan_entry/{plan_id}/{entry_id}

Parameterها #

این method همان قالب پاسخ get_attachments_for_plan را برمی‌گرداند.

کدهای پاسخ #

get_attachments_for_run #

GET index.php?/api/v2/get_attachments_for_run/{run_id}?limit={limit}&offset={offset}

Parameterها #

این method همان قالب پاسخ get_attachments_for_plan را برمی‌گرداند.

فیلترهای request #

می‌توانید فیلترهای زیر را اعمال کنید:

کدهای پاسخ #

get_attachments_for_test #

فهرست پیوست‌های resultهای یک test را برمی‌گرداند.

GET index.php?/api/v2/get_attachments_for_test/{test_id}

Parameterها #

این method همان قالب پاسخ get_attachments_for_case را برمی‌گرداند.

کدهای پاسخ #

get_attachment #

GET index.php?/api/v2/get_attachment/{attachment_id}

Parameterها #

کدهای پاسخ #

delete_attachment #

پیوستی را که با attachment_id مشخص شده است حذف می‌کند.

POST index.php?/api/v2/delete_attachment/{attachment_id}

Parameterها #

محتوای پاسخ #

یک request موفق POST به delete_attachment بدنه پاسخ خالی و کد پاسخ ۲۰۰ برمی‌گرداند.

کدهای پاسخ #