Versioning Automated Testing Interface (v0.1.2) Esta interface é fornecida por um USS (UAS Service Supplier) que deseja fornecer informações sobre a(s) versão(ões) do seu software para destinatários autorizados de maneira automatizada. Segurança (Autenticação) Tipo: OAuth2 (Client Credentials) Escopo Necessário: interuss.versioning.read_system_versions Descrição: Permite que o cliente leia a(s) versão(ões) do software do USS implantado neste ambiente. O token JWT deve ser enviado no header Authorization: Bearer . Endpoints 1. Consultar Versão do Sistema (System Version) Rota: GET /versions/{system_identity} Obtém a versão do sistema solicitado com base em seu identificador de limite (system boundary). Parâmetros de Rota: system_identity (obrigatório) - Um identificador de limite de sistema conhecido tanto pelo cliente quanto pelo USS. O valor deve ser URL-safe (geralmente estruturado em ordem reversa de domínio, similar a pacotes Java). Exemplo: gov.eu.uspace.v1.netid ou gov.au.casa.operating_rules.v2_6 . Respostas Esperadas: 200 OK: A interface forneceu com sucesso a versão do sistema/limite solicitado. Retorna o schema GetVersionResponse . 401 Unauthorized: Token ausente, não decodificado ou inválido. 403 Forbidden: O token foi decodificado com sucesso, mas não inclui o escopo apropriado para este endpoint. 404 Not Found: A identidade/limite do sistema solicitada não é conhecida, ou a interface de automação de versão não está disponível. Payload de Exemplo (JSON) Exemplo de Resposta de Versão ( GET /versions/{system_identity} ) Formato esperado retornando a identidade do sistema solicitado e sua versão atual (preferencialmente utilizando controle de versão semântico). JSON { "system_identity": "gov.au.casa.operating_rules.v2_6", "system_version": "v2.19.53117-rc8+d3a7521f" }