Skip to content

Listing Applications

This document highlights different use cases to list applications and their versions, the following HTTP request you may need related api documentation:

  1. a POST request with your username and password and receive a lightweight token that will enable you as a user to authenticate future requests.
  2. a GET request to receive a list of all catalog applications.
  3. a GET request to receive the versions of the catalog application.
  4. a GET request to receive the details of a specific catalog application.

Get authentication token for IEM API

See Authentication guide.

List Applications

Use this request to list all the applications owned by a user and applications shared with the user:

curl -i -X GET \
-H "Authorization:<your-authorization-token>" \
'https://<your-iem-url>/portal/api/v1/developer-applications/'

A successful response looks like this:

{
    "data": {
        "developer-applications": [
            {
                "id": "6f35d459cd4840adaf95b7338c22b77b",
                "userId": "ef0c10d0d76b49fdbb99a5c7780ff5bb",
                "title": "app11",
                "iconUrl": "https://localhost:443/pp/PortalCache/app/6f35d459cd4840adaf95b7338c22b77b/1.png"
            }
        ]
    }
}

List Application versions

List all versions of a specific application. For this, you require the application ID of the application as unique identifier:

curl -i -X GET \
-H "Authorization:<your-authorization-token>" \
'https://<your-iem-url>/portal/api/v1/developer-applications/<your-app-id>/versions'

A successful response looks like this:

{
    "data": {
        "versions": [
            {
                "id": "3B3877scAqeqHo38XSb11ro4yL5rUxty",
                "number": "0.0.1",
                "status": 5
            }
        ]
    }
}

List Application details

To list the details of a specific application, you need the application ID of the application as a unique identifier:

curl -i -X GET \
-H "Authorization:<your-authorization-token>" \
'https://<your-iem-url>/portal/api/v1/developer-applications/<your-app-id>'

A successful response looks like this:

{
    "projectId": "161fe7016b694f77abd9ade9c9491b82",
    "description": "tetttt",
    "appStatus": "ACTIVE",
    "appLabels": [],
    "id": "6807df8753a2426c9fc9559345289421",
    "title": "test",
    "iconUrl": "https://localhost:443/pp/PortalCache/app/6807df8753a2426c9fc9559345289421/4.png"
}