Get Repository Items List

Gets a list of the items that currently reside in the Perfecto repository. A single request returns up to 2000 items.

Tip:

To view more than 2000 results, use the pageSize and skip Request parameters to page the results.

URL

Copy
https://<your-cloud>.app.perfectomobile.com/repository/api/v1/artifacts?artifactType={artifactType}

Method

GET

Header parameters

Name

Description

Perfecto-Authorization

Security Token

Request parameters

Parameter Description
artifactType

Optional. Defines the artifact type. Can have one of the following values:

  • GENERAL

  • IOS (file types video/*)

  • SIMULATOR (file type .ipa)

  • ANDROID (file types .apk,.apks, or .aab)

  • IMAGE (file types .bmp, .gif, .jpg, .png, .tiff, .svg, and .webp)

  • AUDIO (file types .mp3, .wav, audio/*)

  • VIDEO (file types video/*)

  • SCRIPT (file types .js)

skip

Optional. Specifies how many elements to skip, if any. If used, 0 means not to skip any elements, 10 means to skip 10 elements, and so on.

pageSize

Optional. Specifies how many artifacts to retrieve per request. For example, a value of 1 means to return 1 element per request.

Success response

Code: 200

Content:

Copy
{
    "artifacts": [
        {
            "artifactLocator": "PUBLIC:file_contexts.apk",
            "username": "",
            "groupKey": "",
             "artifactMetadata": {
                 "artifactName": "file_contexts.apk",
                 "artifactSize": 100973,
                 "mimeType": "" ,
                 "artifactType": "ANDROID",
                 "information": [
                     {
                         "name": "version",
                         "value": "1.0.0"
                     }
                 ],
             },
             "usageMetadata": {
                 "creationTime": 1596574465567,
                 "lastUpdateTime": 1596574465567,
                 "lastDownloadTime": 1597771764479
             }
        },
        {
            "artifactLocator": "PUBLIC:Perfecto.jpg",
            "username": "ci@reportium.com",
            "artifactMetadata": {
                "artifactName": "Perfecto.jpg",
                "artifactSize": 16193,
                "mimeType": "image/jpeg",
                "artifactType": "GENERAL",
                "information": [],
                "tags": []
            },
            "usageMetadata": {
                "creationTime": 1652703930090,
                "lastUpdateTime": 1652703930090,
                "lastDownloadTime": 1658744561550
            }
        },
       …
    ]
}

Error response

Error code Reason
206 PARTIAL CONTENT Content has only been received partially
401 UNAUTHORIZED Wrong security token
500 INTERNAL_SERVER_ERROR Internal error