Function

This API is used to query apps.

URI

GET /v2/{project_id}/apps

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
limit	No	Integer	Maximum number of apps to list in a single API call. Value range: 1-100 Default value: 10 Minimum: 1 Maximum: 100 Default: 10
start_app_name	No	String	Name of the app to start the list with. The returned app list does not contain this app name.
stream_name	No	String	Name of the stream whose apps will be returned.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. The token can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
has_more_app	Boolean	Specifies whether there are more matching consumer applications to list. true: yes false: no
apps	Array of DescribeAppResult objects	AppEntry list that meets the current request.
total_number	Integer	Total number of apps that meet criteria.

**Table 5** DescribeAppResult
Parameter	Type	Description
app_name	String	Name of the app.
app_id	String	Unique identifier of the app.
create_time	Long	Time when the app is created, in milliseconds.
commit_checkpoint_stream_names	Array of strings	List of associated streams.

Example Requests

Querying Apps

GET https://{Endpoint}/v2/{project_id}/apps

Example Responses

Status code: 200

Normal response.

{
  "total_number" : 1,
  "apps" : [ {
    "app_id" : "bd6IPpvgiIflQPMpi9M",
    "app_name" : "newstream",
    "create_time" : 1593569685875
  } ],
  "has_more_app" : true
}

Status Codes

Status Code	Description
200	Normal response.
400	Invalid Parameters
404	Application not found
500	Internal Server Error

Error Codes

See Error Codes.