xTrace: Open API Tavsifi

Open API mahsulot ayirboshlash ishtirokchilari (MAI)ning Raqamli markirovka axborot tizimi bilan o‘zaro ishlashi uchun mo‘ljallangan va quyidagi markirovka kodlari (KM) bo‘yicha operatsiyalarni bajarish imkonini beradi:

• KM ro‘yxatini olish;
• KM bo‘yicha ommaviy va batafsil ma’lumotlarni olish;
• kontragent ro‘yxatdan o‘tganligini tekshirish;
• KMni topshirish bo‘yicha so‘rov yuborish va ko‘rib chiqish;
• AIKni shakllantirish va bekor qilish;
• KITUni agregatsiya va dezagregatsiya qilish;
• tovar ta’riflari (kartochkalari)ni tekshirish.

Hujjatning v.1.7.2 versiyasidan boshlab, ICOM metodlari uchun biznes-foydalanuvchi API-kaliti orqali API-so‘rovlarni yuborishga ruxsat berilgan. Shu munosabat bilan quyidagi operatsiyalar bo‘yicha ishlash imkoniyati qo‘shildi:

• KM buyurtmalari bilan ishlash;
• hisobotlar bilan ishlash;
• hujjatlarni ko‘rish va yuborish.

MAI nomidan Open API bilan ishlash uchun Authorization sarlavhasida qo‘llaniladigan bearerToken turidagi API-kalit yaratish tavsiya etiladi.
Uning talablari va yaratish tartibi «API-kalit yaratish» maqolasida keltirilgan.

True API bilan solishtirganda asosiy o‘zgarishlar:

• avtorizatsiya sxemasi o‘zgartirilgan;
• so‘rovlarni yuborish va javoblarni olish sxemasi o‘zgartirilgan;
• qaytariladigan parametrlar ma’lumotnomasi yangilangan.

public/api/cod/private/codes metodida qaytariladigan ma’lumotlar tarkibi kengaytirildi — endi u avval faqat qo‘shimcha parametrlar orqali mavjud bo‘lgan aksariyat qiymatlarni o‘z ichiga oladi.

Agar zarur huquqlar mavjud bo‘lmasa (ya’ni so‘rov yuboruvchi qidirilayotgan kodning joriy egasi bo‘lmasa), public/api/cod/private/codes ga yuborilgan so‘rov avtomatik ravishda public/api/cod/public/codes metodiga yo‘naltiriladi.

25.08.2025 dan boshlab avtorizatsiya sxemasi

Dokumentatsiyani yuklab olish ⬇️