📮
Veb-sayt

Postman bilan API sinaş: sörovdan avtomatlaştirişgaça töliq yöl

29.03.2026
← Barça maqolalar

Zamonaviy veb-loyihalarning deyarli barçasi API'lar ustiga quriladi. Frontend serverdan ma'lumot oladi, mobil ilova bulutga ulanadi, tölov tizimlari bir-biri bilan sörovlar almaşadi. Bularning hammasi töğri işlayotganiga işonç hosil qiliş uçun har bir sörovni qölda brauzerda tekşiriş mumkin emas. Aynan şu yerda Postman maydonga çiqadi. Postman API'larni sinaş, hujjatlaş va avtomatlaştiriş uçun möljallangan eng maşhur vositadir va u oddiy GET sörovini yuborişdan tortib butun bir test töplamini CI quvuriga ulaşgaça bölgan işlarni qamrab oladi.

Uşbu maqolada biz Postman'ni noldan örganamiz. Avval interfeys va asosiy sörovlar bilan tanişamiz, söngra kolleksiya va muhitlardan foydalanib işni tartibga solamiz. Keyin JavaScript test skriptlari yozib, API javoblarini avtomatik tekşirişni köramiz va nihoyat Collection Runner hamda Newman yordamida butun test töplamini avtomatlaştirib, uni doimiy integratsiya jarayoniga qöşamiz. Maqola dasturçilar va testerlar uçun bir xil darajada foydali.

Postman nima va u nima uçun kerak

Postman — bu HTTP sörovlarini quriş va yuboriş uçun grafik muhit. Brauzer faqat GET sörovlarini qulay yuborsa, Postman POST, PUT, DELETE, PATCH kabi barça metodlarni qöllab-quvvatlaydi, header'lar va body'ni aniq sozlaş imkonini beradi hamda javobni çiroyli formatda körsatadi. Eng muhimi, Postman har bir sörovni saqlab, ularni kolleksiyalarga guruhlab, jamoa bilan ulaşiş imkonini beradi. Bu API ustida işlayotgan jamoa uçun yagona haqiqat manbai bölib xizmat qiladi.

Postman'ning kuçi şundaki, u şunçaki sörov yuboruvçi emas. U sizga API hujjatlarini avtomatik yaratiş, soxta server (mock server) işga tuşiriş, monitoring örnatiş va eng asosiysi avtomatik testlar yoziş imkonini beradi. Şu sababli köp jamoalarda Postman API'ning butun hayot tsiklini boşqaradigan markaziy vositaga aylanadi.

Birinçi sörov: GET va POST

Postman'ni oçganingizdan söng yangi sörov yaratasiz, metodni tanlaysiz va URL'ni kiritasiz. Oddiy GET sörovi ma'lumot olib keliş uçun işlatiladi. Masalan, foydalanuvçilar röyxatini oliş uçun siz quyidagiça sörov yuborasiz va Postman javobni JSON körinişida körsatadi:

GET https://api.example.com/v1/users
Accept: application/json

# Javob:
{
  "data": [
    { "id": 1, "name": "Ali" },
    { "id": 2, "name": "Vali" }
  ]
}

POST sörovi esa server'ga yangi ma'lumot yuboriş uçun işlatiladi. Bunda siz Body bölimiga ötib, raw va JSON formatini tanlaysiz hamda yuboriladigan ma'lumotni yozasiz. Authentication kerak bölsa, Authorization bölimida Bearer Token yoki API Key turini tanlaysiz. Quyidagi misol yangi foydalanuvçi yaratişni körsatadi:

POST https://api.example.com/v1/users
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiI...

{
  "name": "Sardor",
  "email": "sardor@example.com"
}

Kolleksiya va muhit (environment)

Bir neçta sörov bilan işlay boşlaganingizda ularni tartibga soliş zarurati tuğiladi. Kolleksiya — bu özaro boğliq sörovlar töplami, masalan "Foydalanuvçilar API" yoki "Tölov API". Kolleksiyalar sörovlarni papkalarga ajratiş, ularga tavsif yoziş va butun töplamni bir marta işga tuşiriş imkonini beradi. Bu API'ni tartibli holatda saqlaşning asosiy usuli.

Muhit (environment) esa özgaruvçilar töplami bölib, u bir xil kolleksiyani turli şaroitlarda işlatiş imkonini beradi. Masalan, sizda "dev", "staging" va "production" muhitlari bölişi mumkin va har birida URL hamda token boşqaça. Sörovlarda qattiq kodlangan qiymatlar örniga {{base_url}} kabi özgaruvçilardan foydalanasiz va muhitni almaştirgan zahoti barça sörovlar yangi qiymatlar bilan işlay boşlaydi:

// Muhit o'zgaruvchilari:
base_url = https://api.example.com/v1
token    = eyJhbGciOiJIUzI1NiI...

// So'rovda ishlatish:
GET {{base_url}}/users
Authorization: Bearer {{token}}

Test yoziş: JavaScript skriptlari

Postman'ning eng kuçli tomoni har bir sörovga test skriptlari biriktiriş imkoniyatidir. Bu skriptlar JavaScript'da yoziladi va sörovdan javob kelgandan keyin avtomatik işga tuşadi. Test skriptlari javobning töğriligini tekşiradi: status kodi kutilganga mosmi, javob qança vaqtda keldi, body içida kerakli maydonlar bormi. Pastdagi misolda status kodi va javob tuzilişini tekşiruvçi oddiy testlar körsatilgan:

pm.test("Status kodi 200 bo'lsin", function () {
    pm.response.to.have.status(200);
});

pm.test("Javob 500ms dan tez kelsin", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

pm.test("Javobda data massivi bor", function () {
    const json = pm.response.json();
    pm.expect(json.data).to.be.an('array');
    pm.expect(json.data.length).to.be.above(0);
});

Test skriptlari nafaqat tekşiradi, balki keyingi sörovlar uçun özgaruvçilarni saqlay oladi. Masalan, login sörovidan kelgan token'ni özgaruvçiga saqlab, keyingi sörovlarda undan foydalaniş juda keng tarqalgan amaliyot. Bu zanjirli (çained) sörovlar tuziş imkonini beradi:

// Login javobidan token'ni olib saqlash:
const json = pm.response.json();
pm.environment.set("token", json.access_token);

// Endi keyingi so'rovlarda {{token}} avtomatik ishlaydi

Avtomatlaştiriş: Collection Runner va Newman

Bir neçta sörov va ularning testlari tayyor bölgaç, ularni birma-bir qölda işga tuşiriş örniga butun kolleksiyani avtomatik işga tuşiriş mumkin. Collection Runner — bu Postman içidagi vosita bölib, u kolleksiyadagi barça sörovlarni ketma-ket yuboradi va har bir testning natijasini körsatadi. Siz hatto CSV fayldan ma'lumot olib, bitta sörovni turli kiruvçi qiymatlar bilan köp marta işga tuşirişingiz mumkin.

Haqiqiy avtomatlaştiriş esa Newman bilan boşlanadi. Newman — bu Postman kolleksiyalarini buyruqlar qatorida (command line) işga tuşiradigan vosita. U sizga testlarni har bir kod özgarişidan keyin avtomatik işga tuşiriş, ya'ni doimiy integratsiya (CI/CD) quvuriga ulaş imkonini beradi. Quyidagi misol Newman'ni örnatiş va kolleksiyani işga tuşirişni körsatadi:

# Newman'ni o'rnatish:
npm install -g newman

# Kolleksiyani muhit bilan ishga tushirish:
newman run users-api.postman_collection.json \
  -e production.postman_environment.json \
  --reporters cli,json

Bu buyruqni GitHub Actions yoki GitLab CI içiga qöyib, har bir puş'dan keyin API testlari avtomatik işlaşini ta'minlaş mumkin. Agar biror test muvaffaqiyatsiz tugasa, quvur töxtaydi va jamoa darhol xabardor böladi. Bu API regressiyalarini işlab çiqarişga çiqişdan oldin tutib qolişning eng işonçli usuli.

Mock server va real iş jarayoni

Ba'zan frontend jamoasi API tayyor bölişini kutmasdan işni boşlaşi kerak. Postman'ning mock server imkoniyati aynan şu vaziyat uçun. Siz kolleksiyaga kutilayotgan javoblarni namuna sifatida saqlaysiz va Postman sizga real API'ni taqlid qiluvçi URL beradi. Frontend bu soxta server bilan işlab tura oladi, keyin esa real API tayyor bölganda oddiygina URL'ni almaştirasiz.

Real iş jarayoni odatda quyidagiça keçadi: dasturçi yangi endpoint yozadi, uni Postman'da qölda sinaydi, söngra unga test skriptlari qöşib kolleksiyaga saqlaydi. Tester bu kolleksiyani kengaytirib, çegaraviy holatlarni qoplaydi. Nihoyat butun kolleksiya Newman orqali CI quvuriga ulanadi va har bir relizda avtomatik işlaydi. Şunday qilib Postman bitta vositada API'ning butun hayotini — birinçi sörovdan to avtomatlaştirilgan regressiya testlarigaça — boşqariş imkonini beradi. Bu nafaqat vaqtni tejaydi, balki API sifatini barqaror saqlaydi.

Öxşaş maqolalar

🧾 Onlayn dökon va fiskal çek: virtual kassa talablari 💻 IT kompaniya sayti: software house, autsorsing va developer servisi uçun strategiya 🌾 Qişloq xöjaligi va agrobiznes sayti: mahsulotlar katalogi va B2B sotuv 🧪 Tibbiy laboratoriya sayti: testlar katalogi, onlayn buyurtma va natija oliş
🌐 Til
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) ✓ 🇺🇿 Ўзбек 🇷🇺 Русский 🇬🇧 English