Instruirea clienților, în privința utilizării mediului de test virtual, pentru API-uri

Ce este mediul de test virtual?

Mediul de test virtual, pentru API-uri, este un serviciu care simulează comportamentul mediului de producție.Serviciul nostru virtual asigură o experiență consecventă, în care răspunsul pe care îl primiți este predefinit și nu variază întotdeauna în funcție de valorile specifice, pe care le furnizați.

Iată un exemplu. Să presupunem că efectuați mai multe apeluri cu aceeași solicitare de tarif, schimbând locațiile expeditorului și destinatarului la fiecare test. API-ul va returna același răspuns predefinit, privind tariful, indiferent de modificările de adresă. Deși este posibil ca valorile să nu corespundă, structura răspunsului va simula ceea ce ați primi în mediul real.

Deoarece serviciul virtual nu comunică cu componentele sistemului backend de producție, testele de integrare sunt izolate de dependențele backend-ului, în timp ce obțineți în continuare un răspuns adecvat.

De ce este mediul de test FedEx virtualizat?

În sistemele complexe, interdependente, cum este sistemul FedEx, există, din păcate, unele situații, puține la număr, în care o resursă dependentă devine indisponibilă și disponibilitatea sistemului are de suferit. Când apar astfel de incidente, chiar dacă probabilitatea este mică, ar putea exista un impact negativ asupra testării integrării API-urilor. Există și alte constrângeri în instanțele în timp real care ar putea restricționa amploarea testării integrării. Prin exemple se numără următoarele:

  • contul de expediere nu a solicitat acces pentru testarea unui anumit scenariu;
  • disponibilitatea limitată a datelor de testare;
  • durate de nefuncționare a sistemului planificate sau neplanificate.

Cum puteți utiliza o instanță a mediului de test virtual?

  • Familiarizați-vă cu documentația API-urilor, destinația cererilor API și metoda de autentificare. Acest lucru va ajuta la proiectarea unor teste eficiente.
  • Descărcați colecția de API-uri pentru JSON, furnizată în cadrul documentației API-urilor, și familiarizați-vă cu aceasta.
  • Alegeți și testați exemple de tranzacții, care se potrivesc scenariilor dumneavoastră de utilizare. Pentru o experiență consecventă, evitați să modificați structura cererii, astfel încât să primiți răspunsul virtual.
  • Vă rugăm să rețineți că nu toate valorile introduse vor afecta răspunsul. În schimb, concentrați-vă pe înțelegerea modului în care aplicația dumneavoastră gestionează răspunsurile consecvente.
  • Testați toate API-urile pentru un comportament adecvat, în conformitate cu documentația. Includeți atât scenarii de testare valide, cât și invalide.
  • Utilizați răspunsurile primite în urma testări cu scenarii invalide pentru a înțelege modul în care sunt returnate mesajele de eroare și statusurile. Acest lucru va ajuta la determinarea modului în care aplicația dumneavoastră ar trebui să gestioneze erorile. Verificați colecția de API-uri pentru JSON și scenariile de testare notate cu prefixul „Negativ”.

Beneficiile mediului virtual

  • Mai puține șanse de indisponibilitate a resurselor.
  • O dependență redusă, în raport cu datele de testare.
  • Răspuns mai rapid, în comparație cu mediul de producție.
  • Nu este necesar un acces special la nivelul contului de client, pentru serviciile speciale.
  • Experiență de integrare facilă, care ușurează procesul de testare și certificare.

Întrebări frecvente

  1. Cum aș putea face ca cererile să se trimită către mediul de test virtual?
    Fiecare documentație pentru API conține colecția API pentru JSON furnizată. Vizitați catalogul de API-uri și deschideți documentația pentru API. Consultați secțiunea „Colecția API pentru JSON”, din documentația pentru API. Această colecție API pentru JSON are salvate toate cererile pentru a primi răspunsuri de la mediul de test virtual.
  2. Trebuie să obțin tokenul pentru a accesa mediul de test virtual?
    Da. Generarea de tokenuri și autorizarea vor funcționa așa cum sunt și trebuie să transmiteți tokenul pentru fiecare tranzacție care interacționează cu mediul de test virtual.
  3. Cum pot ști dacă răspunsul este returnat de la serviciul virtual?
    Răspunsul de la mediul virtual ar include alerta de mai jos, ca parte a mesajului.

  4. În API-ul pentru tarife și timpi de tranzit, de ce nu este validată adresa specificată în cerere?
    Validarea adresei nu se face în cadrul returnării răspunsului. Doar țara este validată, astfel încât puteți trece orice valoare în restul câmpurilor de adresă.
  5. Sunt toate API-urile incluse în mediul de test virtual?
    Până în prezent, au fost incluse doar următoarele API-uri. Se lucrează în prezent la adăugarea celorlalte API-uri.
API pentru tarife și timpi de tranzit Virtualizat
API de urmărire Virtualizat
API Freight LTL – Tarif și capacitate de ridicare Virtualizat
API de validare a adresei Virtualizat
API de validare a codurilor poștale Virtualizat
API de solicitare de preluare Virtualizat
API de disponibilitate a serviciilor Virtualizat
API-ul Global Trade Virtualizat
API de închidere la sfârșitul zilei Virtualizat
API-ul de expediere deschisă Virtualizat
API de expediere Virtualizat
API căutare locație FedEx Virtualizat