Legacy | Get Repository Item Information

Restriction: This information no longer refers to the latest product version but may still be relevant if you are working with an older version.

Retrieves detailed information of a single item from the repository area.

<repository> is specified as follows: 

  • media - the repository area for general media files
  • datatables - the repository area for data table files
  • scripts - the repository area for automation script files
Note:

If the <repository> part is not specified, an error message in the following form will be generated: {"errorMessage": "Failed to get repository item info - Invalid data type PUBLIC:ATT"}.

Syntax

Copy 
https://mycloud.perfectomobile.com/services/repositories/<repository>/<repositoryItemKey>?operation=info&securityToken=value[&optionalParameter=value]
Important: All REST API commands require authentication. See the general authentication methods in Authentication and authorization.

Parameters

Name Type Default Description
securityToken* string
A unique cryptographic key assigned to an authorized user.
admin  string 
true to allow users with administrative credentials to get the status of one or more items from the repository of other automation users. 
owner  string 
The user name of the user who owns the item. This parameter is used in conjunction with the admin parameter to correctly identify items stored in PRIVATE or GROUP repositories of the owner. For example, if a user with administrative credentials wants to get info for repositoryItemKey, specify the parameters as admin=true and owner=itemUser.
group  string 
The group name. This parameter is used in conjunction with the admin parameter to correctly identify items stored in GROUP repositories. For example, if a user with administrative credentials wants to get info for repositoryItemKey. specify the parameters as admin=true and group= groupName.
responseFormat string  json Format of response: json, xml

* Mandatory parameter

Response

The response provides the following information for the item:

  • Repository key for the item
  • Type (simple or container)
  • Creation information (Date of creation and Created By)
  • Modification information (Date of last modification and Modified By)

Examples

Request without optional parameters

This example shows the request and response for listing the items in the appium folder located in the PUBLIC subarea of the media repository area.

Copy

Request without optional parameters

https://mycloud.perfectomobile.com/services/repositories/media/PUBLIC:appium/my_app.ipa?operation=info&securityToken=<your_token> 
Copy

JSON response

{
    "info": {
        "creationTime": {
            "formatted": "2018-08-08T14:08:26Z",
            "millis": "1533737306999"            },
        "modelVersion": "2.22.0.0",
        "productVersion": "master-SNAPSHOT",
        "time": "2018-08-08T14:08:26Z"        },
    "item": {
        "createdBy": "<email address>",
        "creationTime": {
            "formatted": "2015-12-12T01:49:31Z",
            "millis": "1449884971186"            },
        "key": "PUBLIC:DD_StoreLocation.png",
        "modificationTime": {
            "formatted": "2015-12-12T01:49:31Z",
            "millis": "1449884971186"            },
        "modifiedBy": "<email address>",
        "type": "simple"        }
    }