CRM, 1С және өз скриптіңізге арналған API

KASPIRACE қосымшасында істейтін нәрсенің бәрін API арқылы да істеуге болады: ең төмен бағаны, қоймадағы қалдықты өзгерту, турбоны қосу, бәсекелестердің бағасы мен тапсырыстарды көру. Осылай CRM, 1С немесе өз скриптіңізді ботпен байланыстыруға болады: мысалы, сатып алу бағасы өзгергенде CRM жаңа қалдықтар мен ең төмен бағаны өзі жібереді.

API бағдарламаңызды баптайтын адамға керек — сізге немесе бағдарламашыңызға. Боттың жұмыс істеуі үшін API керек емес.

Кілтті қалай жасау керек

1. Сол жақ мәзірден «Автоматтандыру (API)» бөлімін ашыңыз. Телефонда экранның жоғарғы жағындағы аватарыңызды басып, «Автоматтандыру (API)» таңдаңыз.
2. «Кілт жасау» батырмасын басыңыз.
3. Кейін кілтті қай бағдарлама қолданатынын білу үшін атау жазыңыз. Мысалы, «CRM — қалдықтар».
4. Дүкендерді таңдаңыз: «Барлық дүкендер» (кейін қосатын дүкендер де) немесе «Тек таңдалғандар».
5. Рұқсатты таңдап, «Кілт жасау» батырмасын басыңыз.
6. Кілтті көшіріп, бағдарламаңызда сақтаңыз.

Кілт бір-ақ рет көрсетіледі. Кейін оны көру мүмкін емес — тек жаңасын жасауға болады. Кілт kr_live_ деп басталады.

Қандай рұқсат таңдау керек

Рұқсат	Бағдарлама не істей алады
Көру	Тек көру: тауарлар, бағалар, бәсекелестер, тапсырыстар, статистика.
Өзгерту	Көру + тауарларды өзгерту: ең төмен және ең жоғары баға, қадам, қалдық, бақылау, турбо.
Толық	Қосымшадағының бәрі: оған қоса төлем, ботты іске қосу және тоқтату, дүкенді өшіру.

Бағдарламаға жететін ең аз рұқсатты беріңіз. Қалдықтар мен ең төмен бағаны жіберетін CRM-ге «Өзгерту» рұқсаты жеткілікті. Кілт тек сіздің дүкендеріңізбен жұмыс істейді және аккаунтыңыздан артық ештеңе істей алмайды: егер сізге басқа біреудің дүкеніне қолжетімділік берілсе, оны API арқылы да өшіруге немесе төлеуге болмайды.

Жаңа дүкенді қосу және кілт жасау тек қосымшада ғана мүмкін.

Алғашқы сұраныс

API мекенжайы — https://api.kaspirace.kz/v1. Кілт Authorization тақырыбында жіберіледі:

curl https://api.kaspirace.kz/v1/merchants/ \
  -H "Authorization: Bearer kr_live_СІЗДІҢ_КІЛТІҢІЗ"

Жауапта дүкендеріңіз келеді. Олардың id мәні басқа сұраныстарда керек. Мысалы, екі тауардың ең төмен бағасын SKU бойынша барлық қалада былай өзгертесіз:

curl -X POST https://api.kaspirace.kz/v1/merchants/1/products/bulk-update \
  -H "Authorization: Bearer kr_live_СІЗДІҢ_КІЛТІҢІЗ" \
  -H "Content-Type: application/json" \
  -d '{"skus": ["100200300", "100200301"], "min_price": 45000}'

Әдістердің толық тізімі мысалдарымен — «Автоматтандыру (API)» бөліміндегі «Нұсқаулық» қойындысында. Онда сұранысты тікелей браузерден жіберуге және өз құралдарыңыз үшін API сипаттамасын OpenAPI (JSON) форматында жүктеп алуға болады.

Шектеулер

• Бір кілтке минутына 60 сұранысқа дейін. Одан асса, API 429 кодымен және Retry-After тақырыбымен жауап береді — қанша секундтан кейін қайталауға болатыны.
• Kaspi шектеулері. Kaspi бір дүкеннен 30 минутта 2 прайс жүктеуді және 250 баға өзгерісін қабылдайды. Бот өзгерістеріңізді осы шектеуге өзі сыйғызады, сондықтан сұранысты жиі жіберу Kaspi-дегі бағаны тезірек жаңартпайды.
• Қателер жауап денесінде келеді: error өрісінде — сипаттамасы, code өрісінде — бағдарламаға арналған қате коды:

{ "error": "invalid request body", "code": "INVALID_REQUEST_BODY" }

Кілтті қалай қорғау керек

Кілт құпиясөз сияқты дүкендеріңізге кіруге мүмкіндік береді. Оны жарияламаңыз және чатқа жібермеңіз.

Кілттер тізімінде әр кілттің соңғы рет қашан қолданылғаны көрінеді. Кілт енді керек болмаса немесе бөтен адамға түсіп қалуы мүмкін болса, «Өшіру» батырмасын басыңыз. Кілт бірден жұмыс істемей қалады, оны қолданатын бағдарламалар дүкендеріңізбен енді жұмыс істей алмайды. Мұны қайтару мүмкін емес — жаңа кілт жасаңыз.