Alchem
Dasturchilar uchun

Alchem HTTP API va vebxuklari

Yozuvlar va mijozlarni o‘qing va yarating, ustalarning bo‘sh vaqtini va biznes hodisalarini oling. Kalitni salonning o‘zi chiqaradi — kerakli huquqlar va limit bilan.

Bepul sinab ko‘rishHamkorlarga
So‘rov: ustaning bo‘sh vaqti
GET /availability
Asosiy manzil
https://rest.business.eywa.uz/partner/v1
curl
curl "https://rest.business.eywa.uz/partner/v1/availability?staff_id=<staff_id>&service_ids=<service_id>&date=2026-10-01" \
  -H "Authorization: Bearer alk_…"

Kirish qanday tuzilgan

Kalit, huquqlar va limitni salon belgilaydi — siz aynan berilganini olasiz.

Kalitni salon chiqaradi

«Sozlamalar → Integratsiyalar → API kalitlari»da: nom, huquqlar, filiallar va muddat. Kalit bir marta ko‘rsatiladi — javoblar va jurnallarda u yo‘q. Istalgan vaqtda bekor qilish mumkin.

Authorization sarlavhasi

Har bir so‘rov — Authorization: Bearer sarlavhasi va kalit bilan. Kalitsiz yoki bekor qilingan kalit bilan — 401 javobi.

So‘rovlar limiti

Bir kalitga daqiqasiga 10 dan 1200 gacha so‘rov, standart bo‘yicha 300. Limitdan oshsa — Retry-After sarlavhali 429 javobi.

Kalit huquqlari

Kalit faqat ruxsat berilganini ko‘radi — va uni chiqargan xodim hozir qila oladiganidan ortiq emas. Mijozlar kontaktlari — alohida huquq.

Standart bo‘yicha xatolar

Xatolar application/problem+json (RFC 9457) ko‘rinishida keladi: kod, tushunarli xabar va so‘rov manzili.

Vaqt, pul, ro‘yxatlar

Vaqt — filial vaqt mintaqasi siljishi bilan RFC 3339, pul — eng kichik birliklarda. Ro‘yxatlar sahifalab: limit 100 gacha, keyingisi — next_cursor bo‘yicha.

Kalit huquqlari

Bo‘limni o‘zgartirish huquqi uni ko‘rishni ham o‘z ichiga oladi; mijozlar kontaktlari faqat alohida beriladi.

  • Biznes va filiallarbusiness:read
  • Xizmatlar va toifalarservices:read
  • Ustalar va xodimlarstaff:read
  • Ustalarning bo‘sh vaqtiavailability:read
  • Yozuvlar: ko‘rishappointments:read
  • Yozuvlar: yaratish, ko‘chirish, holatni o‘zgartirish, o‘chirishappointments:write
  • Mijozlar: kontaktlarsiz ko‘rishclients:read
  • Mijozlar kontaktlari: telefon va pochtaclients:read_contact
  • Mijozlar: yaratishclients:write
  • Eywa Connect qo‘ng‘iroqlari jurnalicalls:read

Metodlar

Barcha yo‘llar https://rest.business.eywa.uz/partner/v1 asosiy manzilidan. O‘ngda — kalitga kerak bo‘ladigan huquq.

  • GET/meKalit: biznes, huquqlar, filiallar va limit
  • POST/revokeSo‘rov yuborilgan kalitni bekor qilish
  • GET/businessBiznesbusiness:read
  • GET/locationsFiliallarbusiness:read
  • GET/servicesXizmatlar; filial va toifa bo‘yicha filtrservices:read
  • GET/service-categoriesXizmat toifalariservices:read
  • GET/staffUstalar; filial va xizmat bo‘yicha filtrstaff:read
  • GET/availabilityUstaning kunlik bo‘sh vaqtiavailability:read
  • GET/appointmentsDavr bo‘yicha, sanadan keyin o‘zgargan, usta yoki mijoz bo‘yicha yozuvlarappointments:read
  • GET/appointments/{id}Bitta yozuvappointments:read
  • POST/appointmentsYozuv yaratish — yangi yoki mavjud mijoz bilanappointments:write
  • PATCH/appointments/{id}Yozuvni ko‘chirish, holat yoki izohni o‘zgartirishappointments:write
  • DELETE/appointments/{id}Yozuvni o‘chirishappointments:write
  • GET/clientsMijozlar; telefon bo‘yicha qidiruvclients:read
  • GET/clients/{id}Bitta mijozclients:read
  • POST/clientsMijoz qo‘shishclients:write
  • GET/callsDavr bo‘yicha Eywa Connect qo‘ng‘iroqlaricalls:read
  • GET/references/countriesMamlakatlar ma’lumotnomasi
  • GET/references/business-typesBiznes turlari ma’lumotnomasi
  • POST/app/callbackHamkor ilovasi o‘rnatishni tasdiqlaydiapp key
  • POST/app/redirectIlova sozlangandan keyin foydalanuvchini qayerga qaytarishapp key

So‘rovlar namunalari

So‘rov: yangi yozuv
POST /appointments
curl
curl -X POST "https://rest.business.eywa.uz/partner/v1/appointments" \
  -H "Authorization: Bearer alk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "staff_id": "<staff_id>",
    "service_ids": ["<service_id>"],
    "starts_at": "2026-10-01T10:00:00+05:00",
    "client": { "name": "Dilnoza", "phone": "+998901234567" },
    "comment": "…",
    "api_id": "order-1042"
  }'
Javob
GET /availability · 200
JSON
{
  "object": "availability",
  "date": "2026-10-01",
  "time_zone": "Asia/Tashkent",
  "staff_id": "<staff_id>",
  "location_id": "<location_id>",
  "is_working_day": true,
  "duration_minutes": 60,
  "step_minutes": 15,
  "slots": [
    { "starts_at": "2026-10-01T10:00:00+05:00", "ends_at": "2026-10-01T11:00:00+05:00" },
    { "starts_at": "2026-10-01T10:15:00+05:00", "ends_at": "2026-10-01T11:15:00+05:00" }
  ]
}

Vebxuklar

Salon manzilingizni «Sozlamalar → Integratsiyalar → Vebxuklar»da hodisalarga obuna qiladi — butun biznes yoki alohida filiallar uchun.

Nima keladi

JSON bilan POST: event, delivered_at, business_id va data — obyektning o‘zi. X-Eywa-Event va X-Eywa-Delivery-Id sarlavhalari.

Imzo

Obunada maxfiy kalit berilgan bo‘lsa, X-Eywa-Signature’da — so‘rov tanasining o‘n oltilik ko‘rinishdagi HMAC-SHA256’i. O‘z sarlavhalaringizni qo‘shish mumkin.

Qayta urinishlar

2xx javob — yetkazildi. Aks holda 5, 15, 60 va 60 daqiqadan keyin yana urinamiz — jami beshtagacha; javobni 15 soniya kutamiz. Yetkazish jurnali va qo‘lda qayta yuborish — sozlamalarda.

  • Yozuvlarappointment.createdappointment.updatedappointment.cancelledappointment.completedappointment.deleted
  • Mijozlarclient.createdclient.updatedclient.deleted
  • Xizmatlarservice.createdservice.updatedservice.deleted
  • Xizmat toifalariservice_category.createdservice_category.updatedservice_category.deleted
  • Xodimlarstaff.createdstaff.updatedstaff.deleted
  • Ish jadvalischedule.updated
  • Filiallarlocation.createdlocation.updatedlocation.deleted
  • Tovarlargood.createdgood.updatedgood.deleted
  • Ombor amallarigoods_operation.salegoods_operation.receiptgoods_operation.consumablegoods_operation.stolengoods_operation.movegoods_operation.other
  • Moliyaviy amallarfinance_operation.createdfinance_operation.updatedfinance_operation.deleted

Ko‘p salonlar uchun ilova yaratyapsizmi?

Har bir salondan kalit o‘rniga — Alchem katalogidagi ilova: salon bir bosishda kirish beradi, siz o‘rnatishlarni hamkor API’si orqali boshqarasiz.

HamkorlargaIntegratsiyalar

Alchem’ni o‘z saloningizda sinab ko‘ring

7 kun bepul, barcha funksiyalar yoqilgan. Yoki avval salon demosini ko‘ring — ro‘yxatdan o‘tmasdan.

Bepul sinab ko‘rishDemoni ko‘rish