Remote ID Test Data Injection (v0.5.1)

Esta interface é fornecida por cada Provedor de Serviço (Service Provider) que deseja ser testado pelo framework de testes automatizados. A suíte de testes chama esta interface para injetar dados de voo no sistema sob teste.

Segurança (Autenticação)

• Tipo: OAuth2 (Client Credentials)

• Escopo Necessário: rid.inject_test_data

• Descrição: Acesso concedido para injetar dados de teste em um Provedor de Serviços.

Endpoints

1. Criar Teste

Rota: PUT /tests/{test_id}

Solicita a criação de um ou mais voos lógicos baseados na injeção dos dados fornecidos. O ID de injeção (injection_id) não pode ser modificado pelo provedor.

• Parâmetros de Rota: test_id (obrigatório) - O ID do teste. Exemplo: 2979bd18-7f06-441c-bda6-e82c841c35d6

• Corpo da Requisição: Requer o objeto CreateTestParameters (uma lista de voos).

• Respostas Esperadas:

  • 200 OK: Teste criado com sucesso. Retorna ChangeTestResponse.

  • 409 Conflict: O teste já existe.

2. Deletar Teste

Rota: DELETE /tests/{test_id}/{version}

Remove todos os dados de teste associados a este teste do injetor do Provedor de Serviços.

• Parâmetros de Rota: test_id (obrigatório) e version (obrigatório).

• Respostas Esperadas:

  • 200 OK: Teste deletado com sucesso. Retorna DeleteTestResponse.

3. Consultar Notificações de Usuário

Rota: GET /user_notifications

Retorna a lista de notificações observadas pelo usuário virtual. As notificações devem estar disponíveis em até 5 segundos após a observação.

• Parâmetros de Query: * after (obrigatório): Não incluir notificações observadas antes deste horário.

  • before (opcional): Não incluir notificações após este horário. O padrão é o agora.

• Respostas Esperadas:

  • 200 OK: Notificações recuperadas com sucesso.

  • 400 Bad Request: Faltando o parâmetro 'after' ou requisição inválida.

  • 401 Unauthorized: Token ausente, não pôde ser decodificado ou é inválido.

  • 403 Forbidden: Token decodificado, mas sem o escopo apropriado.

Payload de Exemplo (JSON)

Formato esperado para o envio das informações do voo:

{
  "requested_flights": [
    {
      "injection_id": "edb7695f-8737-4b9f-91f8-e2afbb333f41",
      "aircraft_type": "Aeroplane",
      "telemetry": [
        {
          "timestamp": "2024-04-22T16:36:50.52Z",
          "position": {
            "lat": -23.1791,
            "lng": -45.8872,
            "alt": 100.0
          }
        }
      ],
      "details_responses": [
        {
          "effective_after": "2024-04-22T16:36:50.52Z",
          "details": {
            "id": "a3423b-213401-0023"
          }
        }
      ]
    }
  ]
}