AiHummer
Oʻzbekcha▾
Kirish
v1.0.x▾
v1.0.xstable
{ }Swagger
API/Kiruvchi va integratsiya triggerlari

Kiruvchi va integratsiya triggerlari

v1.0.x · yangilandi 2026-06-26

OpenAI bilan mos API’dan tashqari, AiHummer konnektorlar, avtomatlashtirish platformalari va brauzer vidjetidan kiruvchi xabarlarni qabul qiladi, va siz obuna boʻla oladigan server tomonidagi hodisalar oqimini chiqaradi. Bu endpoint’lar tashqi tizimlar ishni gateway’ga qanday yetkazishi va UI’lar qanday jonli qolishidir.

Kiruvchi endpoint’lar

Kiruvchi endpoint’lar kanal konnektorlari va maxsus integratsiyalar xabarni turn engine’ga qanday topshirishidir. Ular X-AIHummer-Inbound-Secret sarlavhasida yuboriladigan HMAC umumiy siri bilan himoyalanadi (AIHUMMER_INBOUND_SECRET orqali sozlanadi).

Metod va yoʻl Maqsad
POST /v1/inbound/telegram Mahalliy Telegram kiruvchi yuklamalari
POST /v1/inbound/generic Email→webhook, cron va maxsus ilovalar uchun umumiy kiruvchi
POST /v1/inbound/binding/status Kanal-bogʻlash holatini xabar qilish

Umumiy endpoint har qanday manbani AiHummer’ga uzatishning eng oddiy usulidir. Kanal nomi, barqaror tashqi identifikator va xabar matni bilan kichik JSON tanasini yuboring:

curl https://your-aihummer.example/v1/inbound/generic \
  -H "X-AIHummer-Inbound-Secret: $AIHUMMER_INBOUND_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "external_id": "ticket-4821",
    "text": "A customer asks whether order #4821 has shipped."
  }'

[!NOTE] Umumiy kiruvchi dispetcher standart ish maydonini talab qiladi. AIHUMMER_DEFAULT_WORKSPACE_ID’ni oʻrnating, shunda kiruvchi xabarlar yoʻnaltirilishi mumkin boʻladi.

[!WARNING] Kiruvchi endpoint’lar ah- API kaliti bilan himoyalanmagan — ular X-AIHummer-Inbound-Secret HMAC’iga tayanadi. Bu sirni mijoz tomonidagi koddan uzoqda saqlang va agar u sizib chiqsa aylantiring.

Integratsiya triggerlari (Zapier / Make)

POST /v1/integrations/trigger — Zapier va Make kabi kam-kodli avtomatlashtirish platformalari uchun kirish nuqtasi. U yo X-AIHummer-Signature HMAC’ini yoki Bearer token’ni qabul qiladi.

curl https://your-aihummer.example/v1/integrations/trigger \
  -H "X-AIHummer-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "zapier",
    "external_id": "lead-99",
    "text": "New lead captured from the contact form."
  }'

Veb vidjet

Joylashtiriladigan veb vidjet ikkita endpoint’dan foydalanadi: biri sessiyani ochish uchun, biri assistant javobini oqimlash uchun.

Metod va yoʻl Maqsad
POST /v1/web/session Vidjet sessiyasini ochish
GET /v1/web/stream Vidjet javoblarini SSE sifatida olish 
# 1) Open a session
curl https://your-aihummer.example/v1/web/session \
  -H "Content-Type: application/json" \
  -d '{}'

# 2) Stream responses (Server-Sent Events)
curl -N https://your-aihummer.example/v1/web/stream

Hodisalar oqimi

GET /v1/events/stream — gateway hodisalarining davom ettiriladigan Server-Sent Events tasmasi. Oldingi ulanish toʻxtagan joydan davom ettirish uchun ?since= kursorini uzating, shunda qayta ulanish hech qachon hodisalarni yoʻqotmaydi.

# Subscribe from the beginning
curl -N https://your-aihummer.example/v1/events/stream

# Resume after a known cursor
curl -N "https://your-aihummer.example/v1/events/stream?since=<cursor>"

[!TIP] Har bir hodisa olib yuradigan qiymatni keyingi since kursori sifatida qabul qiling. Qayta ulanishda iste’molchingizga kamida-bir-marta yetkazishni kafolatlash uchun oʻsha kursordan qayta ijro eting.

Keyin qayerga