Formação do cliente sobre a virtualização da sandbox da API

O que é a virtualização da sandbox?

A virtualização da sandbox da API é um serviço que simula o comportamento da instância de uma sandbox ativa. O nosso serviço virtualizado fornece uma experiência consistente em que a resposta que recebe é predefinida e nem sempre varia com base nos valores de entrada específicos que fornece.

Segue-se um exemplo. Vamos supor que faz várias chamadas com o mesmo pedido de tarifa e muda as localizações do expedidor e do destinatário com cada teste. A API vai devolver a mesma resposta de tarifa predefinida independentemente das alterações de morada. Embora os valores possam não corresponder, a estrutura da resposta simularia o que iria receber no ambiente ativo.

Uma vez que o serviço virtualizado não atinge os componentes do sistema de backend ativo, os testes da sua integração estão protegidos contra dependências de backend enquanto continua a receber a resposta apropriada.

O que é a Sandbox virtualizada da FedEx?

Num sistema complexo e interdependente como o da FedEx, infelizmente existem algumas instâncias em que um recurso dependente se torna indisponível e a disponibilidade do sistema é afetada. Quando estes incidentes ocorrem, apesar de serem isolados, pode ter impacto negativo nos testes de integração da API. Existem outras restrições em instâncias ativas que também podem restringir o âmbito dos seus testes de integração. Alguns exemplos incluem:

• Conta de expedição sem o acesso necessário para testar um determinado cenário específico.
• Disponibilidade limitada de dados de teste.
• Tempo de inatividade do sistema planeado ou não planeado.

Como utilizar a instância da sandbox virtualizada?

• Familiarize-se com a documentação, pontos finais e método de autenticação da API. Isto ajuda a criar testes eficazes.
• Transfira e familiarize-se com a recolha da API JSON fornecida na documentação da API.
• Escolha e teste transações de teste que se adequem aos seus cenários de utilização. Para uma experiência consistente, evite mudar a estrutura da carga do pedido para receber a resposta virtualizada.
• Tenha em atenção que nem todos os valores de entrada vão afetar a resposta. Em alternativa, concentre-se em compreender a forma como a sua aplicação lida com as respostas consistentes.
• Teste todas as API para saber se o comportamento está correto de acordo com a documentação. Inclua casos de teste positivos e negativos.
• Utilize os casos de teste negativos fornecidos para compreender a forma como as mensagens de erro e os códigos de estado são devolvidos. Isto vai ajudar a determinar a forma como a sua aplicação deve gerir erros. Consulte a recolha da API JSON e os casos de teste com o prefixo adicionado como "Negativo".

Vantagens da virtualização

• Menos hipóteses de indisponibilidade de recursos.
• Menos dependência em dados de teste.
• Resposta mais rápida quando comparada com a instância da sandbox ativa.
• Não é necessário o acesso explícito ao nível da conta para os serviços especiais.
• Experiência de integração simples, o que facilita o processo de teste e certificação.

Perguntas frequentes

1. Como faço para que a carga do pedido atinja a resposta de virtualização?
   Cada documentação da API tem a recolha da API JSON fornecida. Aceda ao Catálogo de API e abra a documentação da API. Consulte a secção "Recolha da API JSON" na documentação da API. Esta recolha da API JSON tem todas as cargas do pedido guardadas que obteriam a resposta virtualizada.
2. Tenho de obter o token para aceder à instância de sandbox virtualizada?
   Sim, a criação e autorização de tokens vão funcionar assim como estão e é esperado que passe o token para todas as transações que interagem com o serviço da sandbox virtualizada.
3. Como posso saber se a resposta é devolvida a partir do serviço virtualizado?
   A resposta virtualizada adicionaria o alerta abaixo como parte da carga.
   
   
4. Porque é que a minha morada na carga do pedido não está a ser validada na API de tarifas e tempos de trânsito?
   A validação da morada não pertence à lógica da qual deriva uma resposta de tarifa virtualizada. Apenas o país é validado para que possa transmitir qualquer valor nos restantes campos da morada.
5. Todas as API estão virtualizadas?
   Apenas as API seguintes foram virtualizadas até agora. O processo de virtualização do resto das funcionalidades de API está em curso.