API

API orqali sayt, kassa va CRM sodiqlik dasturlari, promokodlar va referal dasturlari bilan ishlaydi, mahsulot hodisalari esa tizimlaringizga vebhuklar orqali keladi.

API kalitlar

Kalitni rahbar “Integratsiyalar” boʻlimidagi “API kalitlar” yorligʻida chiqaradi. Soʻrov kalit va kompaniyani sarlavhalarda uzatadi, har bir chaqiruv esa jurnalga yoziladi.

API_KEY: <kalit> · CompanyId: <kompaniya id>
  • Kalit muddati 1, 6 yoki 12 oy, toʻlov A3.ID orqali
  • Kalit chiqarilganda bir marta koʻrsatiladi
  • Kalit oshkor boʻlsa, qayta chiqarish
  • Kalit boʻyicha har bir soʻrov jurnali
  • Tushunarli qayta ishlash uchun “KOD: xabar” koʻrinishidagi xatolar

Asosiy soʻrovlar

API ildizidan manzillar, dastur va kompaniya id qiymatlari qoʻyilgan curl, JavaScript va PHP misollari ilovaning “Ulanish” boʻlimida bor.

Sodiqlik dasturlari

SoʻrovVazifasi
POST External/v1/Loyalty/CustomersXaridorni dasturda roʻyxatdan oʻtkazish
GET External/v1/Loyalty/CustomerXaridor balansi va darajasini olish
POST External/v1/Loyalty/QuoteSavatni hisoblash: qancha yechish mumkin va qancha hisoblanadi
POST External/v1/Loyalty/HoldsToʻlovgacha bonuslarni 30 daqiqaga band qilish
POST External/v1/Loyalty/PurchasesXaridni oʻtkazish: bonuslarni yechish va hisoblash
POST External/v1/Loyalty/RefundsBuyurtma qaytarilganda bonuslarni qaytarish

Promokodlar

SoʻrovVazifasi
POST External/v1/Promocodes/ValidateBuyurtma uchun kodni tekshirish va chegirmani hisoblash
POST External/v1/Promocodes/ApplyKodni buyurtmaga qoʻllash
POST External/v1/Promocodes/ReleaseBuyurtma bekor qilinganda kodni boʻshatish

Referal dasturlari

SoʻrovVazifasi
POST External/v1/Referral/ParticipantsIshtirokchini roʻyxatdan oʻtkazish va kod olish
GET External/v1/Referral/ParticipantIshtirokchi maʼlumotlari va balansini olish
POST External/v1/Referral/ConversionsReferal kod boʻyicha xaridni hisobga olish
POST External/v1/Referral/Conversions/CancelQaytarishda konversiyani bekor qilish
POST External/v1/Referral/WithdrawalsMablagʻ yechib olishga ariza yaratish

Vebhuklar

A3.Marketing hodisalarni tizimingiz manziliga yuboradi, shunda CRM, ombor yoki analitika ular haqida jadval boʻyicha emas, darhol bilib oladi.

  • marketing.lead.createdLid paydo boʻldi, jumladan tarqatmaning treking havolasi orqali
  • marketing.lettering.completedTarqatma yakunlandi, yetkazish statistikasi tayyor
  • marketing.unsubscribe.recordedKontakt kanaldagi tarqatmalardan obunani bekor qildi
  • marketing.website.downKompaniya sayti javob bermay qoldi
  • marketing.seo.report.readyAvtoparsingning SEO hisoboti saqlandi

Sayt uchun skript

Kichik skript ?ref= havolasidagi kodni 90 kunga eslab qoladi. Xarid paytida sayt saqlangan kodni oladi va xaridor bir haftadan keyin qaytgan boʻlsa ham konversiyani yuboradi.

Referal dasturlari

Toʻliq hujjatlar

Barcha metodlar, parametrlar va xato kodlari interaktiv API hujjatlarida tasvirlangan. Ilovada ishlash boʻyicha yoʻriqnomalar A3.Solutions vikisida jamlangan.

Sodiqlikni kassangizga ulaymizmi?

Sizda qanday kassa, sayt va CRM borligini aytib bering. Qaysi soʻrovlar kerakligini maslahat beramiz va ulanishni dasturchingiz bilan birga tekshiramiz.