როგორ გადაამოწმებთ, რომ სწორ ველები დაბრუნდით?

პასუხის ზუსტი საჭირო ველების დაბრუნების შემოწმება რამდენიმე გზით შეიძლება, დამოკიდებულია პასუხის ტიპზე (JSON, XML და ა.შ.), გამოყენებულ ინსტრუმენტზე და ტესტირების დონეზე (API, E2E):

1. პასუხის სქემის ვალიდაცია (Schema Validation):

   • ყველაზე საიმედო მეთოდია.
   • შეიქმნება სქემა (JSON Schema, XML Schema), რომელიც აღწერს ელოდებოდათ პასუხის სტრუქტურას და მონაცემთა ტიპებს.
   • პასუხი ვალიდირებულია ამ სქემის მიხედვით.
   • უზრუნველყოფს ველების არსებობას/არ არსებობას, მათი ტიპებს და, სურვილის შემთხვევაში, რეგულარულ გამოთქმებს მნიშვნელობებისთვის.

   // მაგალითი JSON სქემისთვის მომხმარებლის პასუხზე
   {
     "type": "object",
     "properties": {
       "id": { "type": "integer" },
       "name": { "type": "string" },
       "email": { "type": "string", "format": "email" }
     },
     "required": ["id", "name", "email"]
   }
   

2. მხოლოდ ველების არსებობის/არ არსებობის და მნიშვნელობების პირდაპირი შემოწმება (Field Presence and Value Assertion):

   • პასუხის ანალიზი.
   • შემოწმება, რომ ყოველი ელოდებოდათ ველი არსებობს.
   • შემოწმება, რომ არასასურველი ველები არ არსებობს.
   • ველების მონაცემთა ტიპების შემოწმება.
   • ველების მნიშვნელობების შემოწმება (შესაბამისობა კონკრეტულ მნიშვნელობას, რეგულარულ გამოთქმას, დიაპაზონს და ა.შ.).

   # მაგალითი JSON პასუხის შემოწმების Python-ში (requests და pytest გამოყენებით)
   import requests
   import pytest
   
   def test_user_response_fields():
       response = requests.get("http://api.example.com/users/1")
       assert response.status_code == 200
       data = response.json()
   
       # ველების არსებობის შემოწმება
       assert "id" in data
       assert "name" in data
       assert "email" in data
   
       # არასასურველი ველების (მაგ., 'password') არ არსებობის შემოწმება
       assert "password" not in data
   
       # ველების ტიპების შემოწმება
       assert isinstance(data["id"], int)
       assert isinstance(data["name"], str)
       assert isinstance(data["email"], str)
   
       # მნიშვნელობების შემოწმება (მაგ.,)
       assert data["id"] > 0
       assert "@" in data["email"] # ელ.ფოსტის ფორმატის მარტივი შემოწმება
   

3. შედარება სტანდარტთან (Golden Master / Snapshot Testing):

   • წინასწარ ინახება სწორი პასუხი (სტანდარტი).
   • მიმდინარე პასუხი შეადარება სტანდარტს.
   • სასარგებლოა სტრუქტურის სტაბილურობის შემოწმებისთვის, მაგრამ ნაკლებად მოქნილია ცვლილებების დროს.

4. სპეციალიზებული ბიბლიოთეკების/ფრემვორკების გამოყენება:

   • RestAssured (Java)
   • Postman (Newman): საშუალებას იძლევა დაწეროთ JavaScript-ით ტესტები, მათ შორის სქემებისა და ველების შემოწმება.
   • Pytest/unittest და JSON/XML სამუშაო ბიბლიოთეკები.

მეთოდის არჩევა დამოკიდებულია პასუხის სტრუქტურის სირთულეზე, სიზუსტის მოთხოვნებზე და გამოყენებულ ტექნოლოგიურ სტეკზე. სქემის ვალიდაცია არის ოქროს სტანდარტი API ტესტირებისთვის, რადგან ის მოიცავს სტრუქტურის და მონაცემთა ტიპების ყველა ასპექტს.