Tez boshlash

API'ga birinchi muvaffaqiyatli murojaat — taxminan besh daqiqada. Bu yerda api-key usuli ishlatiladi: o'z akkauntingizga murojaat qilganingiz uchun OAuth kerak emas.

1. Integratsiya yarating

Bito panelining chap menyusida Integratsiyalar → Integratsiyalar bo'limini oching va Custom integratsiya tugmasini bosing. Integratsiya yaratish oynasida Tashqi integratsiya qatoridagi + Yaratishni bosing.

Nom kiriting, qolganini hozircha bo'sh qoldiring va Saqlashni bosing. Maydonlarning batafsil tavsifi — Integratsiya yaratish bo'limida.

2. Uchta qiymatni ko'chirib oling

Saqlaganda Bito client_id, secret va api_key qiymatlarini ko'rsatadi. secret faqat shu yerda bir marta ko'rinadi — oynani yopishdan oldin uchalasini ham xavfsiz joyga ko'chiring, qarang: Kalitlaringiz.

Tez boshlash uchun faqat api_key kerak. U shunday ko'rinadi: mycompany:9ad41c0e7b3f28d5610ac94e7f1b26d8.

3. Integratsiyani o'rnating

Integratsiya yaratiladi, lekin o'rnatilmaydi. O'rnatilmagan integratsiyaning har bir API so'rovi Integration is not installed xatosini qaytaradi.

Integratsiyalar sahifasidagi O'rnatilgan ro'yxatida yangi integratsiyangizni oching va O'rnatishni bosing. O'rnatish redirect_uri va webhook_uri ko'rsatilgan bo'lsa ularni ham ishga tushiradi — qarang: O'rnatish va o'chirish hooklari.

4. So'rov yuboring

Ro'yxat so'rovlari POST orqali ketadi — filtrlar tanada yuboriladi. Bitta yozuvni o'qish — GET, yangilash — PUT, o'chirish — DELETE.

bash

curl -X POST \
  'https://api.bito.uz/integration-api/integration/api/v2/product/get-paging' \
  -H 'api-key: mycompany:9ad41c0e7b3f28d5610ac94e7f1b26d8' \
  -H 'Content-Type: application/json' \
  -H 'Accept-Language: uz' \
  -d '{ "page": 1, "limit": 5 }'

Javob

json

{
    "code": 0,
    "message": "Success",
    "status_code": 200,
    "data": {
        "total": 1043,
        "data": [
            { "_id": "6712f0a9c4d1e87b3a0f9911", "name": "Espresso" }
        ]
    },
    "time": "2025-05-01T12:00:00Z"
}

code: 0 — muvaffaqiyat. Yozuvlar data.data ichida, umumiy soni data.total da.

TIP

401 oldingizmi? Sarlavha nomi api-key, Authorization emas, va qiymat ikki nuqtagacha bo'lgan qismni ham o'z ichiga oladi. 404 oldingizmi? Bazaviy URL'ni tekshiring — u /integration/api/v2/ bilan tugaydi.

5. Keyingi yo'lni tanlang

Nima yaratyapsiz	Keyin o'qing
Faqat o'z akkauntingiz uchun yechim	API bilan ishlash, so'ng API ma'lumotnomasi — yoki Bito ichida ekran kerak bo'lsa o'z hisobingiz uchun vidjet
Ko'p mijoz o'rnatadigan marketplace API integratsiyasi	Bito developeri bo'ling, so'ng OAuth 2.0: umumiy
Bito ichida ishlaydigan ommaviy vidjet	Ilova sahifasi, so'ng Maxsus vidjetlar
Ma'lumot o'zgarishiga javob beradigan tizim	Ma'lumot webhooklari

Hammasi ishlagach, integratsiyani tekshiruvga yuboring. Ommaviy vidjetda kartochka va reliz alohida tekshiriladi; tasdiq ilovani o'rnatiladigan qiladi, avtomatik o'rnatmaydi.

Tez boshlash ​

1. Integratsiya yarating ​

2. Uchta qiymatni ko'chirib oling ​

3. Integratsiyani o'rnating ​

4. So'rov yuboring ​