Consulta de versões de API
Função
Esta API é usada para consultar as suportadas versões da API do RDS.
A documentação da API v1 foi colocada off-line, assim como o software correspondente. Para evitar que seus serviços sejam afetados, é aconselhável alternar os serviços para a API v3.
- Antes de chamar uma API, você precisa entender a API em Autenticação.
Solicitação
Resposta
- Resposta normal
Tabela 1 Descrição do parâmetro Nome
Tipo
Descrição
versions
Array of objects
Indica a lista de informações detalhadas sobre a versão da API.
Para mais detalhes, consulte Tabela 2.
Tabela 2 Descrição da estrutura de dados do campo versions Nome
Tipo
Descrição
id
String
Indica a versão da API.
- v1: indica a versão da API v1.
AVISO:
A documentação da API v1 foi colocada off-line, assim como o software correspondente. Para evitar que seus serviços sejam afetados, é aconselhável alternar os serviços para a API v3.
- v3: indica a versão da API v3.
links
Array of objects
Indica as informações do link da API. O valor está vazio quando a versão é v1 ou v3.
Para mais detalhes, consulte Tabela 3.
status
String
Indica o status da versão.
CURRENT: indica que a versão é recomendada.
DEPRECATED: indica uma versão obsoleta que pode ser excluída posteriormente.
updated
String
Indica a hora de atualização da versão.
O formato é yyyy-mm-dd Thh:mm:ssZ.
T é o separador entre o calendário e a notação horária do tempo. Z indica o Tempo Universal Coordenado (UTC).
- v1: indica a versão da API v1.
- Exemplo de resposta normal
{ "versions": [{ "id": "v3", "links": [], "status": "CURRENT", "updated": "2019-01-15T12:00:00Z" }, { "id": "v1", "links": [], "status": "DEPRECATED", "updated": "2017-02-07T17:34:02Z" } ] }
- Resposta anormal
Para mais detalhes, consulte Resultados anormais da solicitação.
Código de status
- Normal
- Anormal
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.