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ʻrov | Vazifasi |
|---|---|
POST External/v1/Loyalty/Customers | Xaridorni dasturda roʻyxatdan oʻtkazish |
GET External/v1/Loyalty/Customer | Xaridor balansi va darajasini olish |
POST External/v1/Loyalty/Quote | Savatni hisoblash: qancha yechish mumkin va qancha hisoblanadi |
POST External/v1/Loyalty/Holds | Toʻlovgacha bonuslarni 30 daqiqaga band qilish |
POST External/v1/Loyalty/Purchases | Xaridni oʻtkazish: bonuslarni yechish va hisoblash |
POST External/v1/Loyalty/Refunds | Buyurtma qaytarilganda bonuslarni qaytarish |
Promokodlar
| Soʻrov | Vazifasi |
|---|---|
POST External/v1/Promocodes/Validate | Buyurtma uchun kodni tekshirish va chegirmani hisoblash |
POST External/v1/Promocodes/Apply | Kodni buyurtmaga qoʻllash |
POST External/v1/Promocodes/Release | Buyurtma bekor qilinganda kodni boʻshatish |
Referal dasturlari
| Soʻrov | Vazifasi |
|---|---|
POST External/v1/Referral/Participants | Ishtirokchini roʻyxatdan oʻtkazish va kod olish |
GET External/v1/Referral/Participant | Ishtirokchi maʼlumotlari va balansini olish |
POST External/v1/Referral/Conversions | Referal kod boʻyicha xaridni hisobga olish |
POST External/v1/Referral/Conversions/Cancel | Qaytarishda konversiyani bekor qilish |
POST External/v1/Referral/Withdrawals | Mablagʻ 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 orqalimarketing.lettering.completedTarqatma yakunlandi, yetkazish statistikasi tayyormarketing.unsubscribe.recordedKontakt kanaldagi tarqatmalardan obunani bekor qildimarketing.website.downKompaniya sayti javob bermay qoldimarketing.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 dasturlariToʻ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.