Consulta de uma lista de aplicações
Função
Esta API é usada para consultar uma lista de aplicações que correspondem às condições especificadas.
URI
A tabela a seguir lista o método de solicitação HTTP/HTTPS e o URI da API.
| Método de solicitação | URI |
|---|---|
| GET | /v1.0/apigw/apps[?page_size, page_no, id, name, app_key, creator] |
- Uma combinação de diferentes condições de consulta pode ser adicionada no final do URI usando pontos de interrogação (?) e E comercial (&).
- As condições de consulta incluem: id, name, app_key, creator, page_size e page_no.
A tabela a seguir lista os parâmetros no URI.
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| id | Não | String | ID de aplicação |
| name | Não | String | Nome de aplicação |
| status | Não | Integer | Status de aplicação |
| app_key | Não | String | AppKey |
| creator | Não | String | Criador de aplicações, que pode ser:
|
| page_size | Não | Integer | Número de registros exibidos em cada página. O valor padrão é 20. |
| page_no | Não | Integer | Número da página. O valor padrão é 1. |
| precise_search | Não | String | Nome do parâmetro (name) para correspondência exata |
Solicitação
N/D
Resposta
| Parâmetro | Tipo | Descrição |
|---|---|---|
| total | Integer | Número de aplicações que correspondem às condições de consulta |
| size | Integer | Comprimento da lista de aplicações retornada |
| apps | Dicionário | Lista de aplicações |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | String | ID de aplicação |
| name | String | Nome de aplicação |
| status | Integer | Status de aplicação |
| app_key | String | AppKey |
| app_secret | String | AppSecret |
| register_time | Timestamp | Hora em que a aplicação é registrada |
| remark | String | Descrição da aplicação |
| update_time | Timestamp | Hora em que a aplicação foi atualizada pela última vez |
| creator | String | Criador de aplicações, que pode ser:
|
| app_type | String | Tipo de aplicação. O valor padrão é apig. |
| bind_num | Integer | Número de APIs às quais a aplicação foi vinculada |
{
"total": 2,
"size": 2,
"apps": [{
"id": "98efd77d-10b5-4eca-8170-ed30a4a286a4",
"name": "app_002",
"status": 1,
"app_key": "f627fbaa-2c8b-4f58-a690-f478f54d3fe2",
"app_secret": "******",
"remark": "Second app",
"register_time": "2017-12-28T12:32:50Z",
"update_time": "2017-12-28T12:32:50Z",
"creator": "MARKET",
"app_type": "apig",
"bind_num": 2
},
{
"id": "14b399ac-967f-4115-bb62-c0346b4537e9",
"name": "app_001",
"status": 1,
"app_key": "d49b1cbf-cc81-4a5f-b2a0-61b568e376eb",
"app_secret": "******",
"remark": "First app",
"register_time": "2017-12-28T12:26:54Z",
"update_time": "2017-12-28T12:29:35.571Z",
"creator": "USER",
"app_type": "apig",
"bind_num": 2
}]
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | OK |
| 400 | Solicitação inválida |
| 401 | Não autorizado |
| 500 | Erro do servidor interno |