ÖRGON Developers
Örgon Taxi va Orgon Pro ishlatadigan xarita, SMS va to‘lov xizmatlari endi sizning ilovangiz uchun ham. Bitta hisob, Kaspi orqali to‘lov, har bir kalit — bitta qurilma.
Manzil qidirish, koordinatadan manzil, xaritadagi joylar va yo‘l bo‘yicha marshrut. Karabulak, Shymkent, Sayram, Aksukent — 17 000+ joy.
Qozog‘istondagi istalgan mobil raqamga SMS: tasdiqlash kodlari, buyurtma holati, eslatmalar. Yetkazildi / yetkazilmadi hisoboti bilan.
Kaspi orqali to‘lov qabul qiling: havola, QR yoki telefon raqamiga hisob. Pul to‘g‘ridan-to‘g‘ri o‘z Kaspi kassangizga tushadi; imzolangan webhook’lar va qaytarish.
Uchala xizmatda bir xil. Örgon Pay’da bundan tashqari kabinetda Kaspi kassangizni ulaysiz va obunani to‘laysiz.
Telefon raqam yoki email va kod bilan — parol yo‘q. Maps, SMS va Pay kabinetlariga bir xil raqam bilan kirasiz: hisob bitta.
Kaspi QR yoki Kaspi’ga hisob orqali, kamida 1 000 ₸. Har bir xizmatning balansi alohida: Maps puli SMS’ga ishlatilmaydi, Pay balansidan esa obuna yechiladi.
Kalit faqat bir marta ko‘rsatiladi — uni serveringizda yoki ilova sozlamalarida saqlang. Har bir xizmatning kaliti o‘ziniki.
Kalitni Authorization sarlavhasida, qurilmangiz nomini X-Device-Id da yuboring. Javob — JSON.
curl "https://maps.orgon.kz/v1/geocode?q=magnum&near=42.52,69.77" \
-H "Authorization: Bearer omk_…" \
-H "X-Device-Id: my-app-1"Javob: items — eng yaqin joylar (id, name, kind, city, lat, lng, distance_m). X-Orgon-Free-Left sarlavhasi oyning qolgan bepul so‘rovlarini ko‘rsatadi.
Kalitning birinchi so‘rovi uni qurilmaga bog‘laydi: X-Device-Id sarlavhasi (ilovangiz yoki serveringizning doimiy nomi), u bo‘lmasa — IP manzil. Uchala xizmatda ham shunday.
Maps va SMS’da boshqa qurilmadan kelgan so‘rov 403 device oladi va hisoblanmaydi. Ilovani yangi serverga ko‘chirsangiz, avval kabinetda qayta bog‘lang (kuniga bir marta).
Maps yoki SMS kaliti bir kunda 3 ta boshqa qurilmada ko‘rinsa, Pay kaliti esa birinchi begona so‘rovdayoq butunlay bloklanadi (403 key-blocked / key_blocked). O‘g‘irlangan kalit ishlamaydi — yangisini oching.
Maps va SMS xatosi bir xil ko‘rinishda: {"ok": false, "error": "device", "message": "…"}. Xatoni error bo‘yicha ishlang, message — odam uchun. Örgon Pay xatolari o‘z hujjatida.
| HTTP | error | Nima bo‘ldi | Nima qilish kerak |
|---|---|---|---|
| 400 | invalid | Parametr noto‘g‘ri (field — qaysi biri) | So‘rovni tuzating; bunday so‘rov hisoblanmaydi |
| 401 | key | Kalit noto‘g‘ri, bekor qilingan yoki boshqa xizmatniki | Kabinetdan to‘g‘ri kalitni oling |
| 402 | payment-required | Balans yetarli emas (Maps’da — bepul so‘rovlar ham tugagan) | Shu xizmatning balansini to‘ldiring |
| 403 | device | Kalit boshqa qurilmaga bog‘langan | Kabinetda «Qurilmani almashtirish» (kuniga bir marta) |
| 403 | key-blocked | Kalit bir kunda 3 ta boshqa qurilmada ko‘rindi — butunlay bloklandi | Yangi kalit oching va uni yashiring |
| 403 | blocked | Hisob bloklangan | Bizga yozing |
| 429 | rate-limit | Sekundiga juda ko‘p so‘rov | Biroz kutib qayta yuboring |
| API | Tezlik | Boshqa |
|---|---|---|
| Maps | bitta kalitga sekundiga 10 ta | bir hisobda 10 tagacha kalit; marshrutda 5 tagacha nuqta |
| SMS | bitta kalitga sekundiga 5 ta | bir hisobdan kuniga 300 ta, bitta raqamga kuniga 10 ta |
| Pay | bitta kalitga sekundiga 20 ta | bir hisobda 1 ta kalit va 1 ta loyiha; bitta to‘lov 1 dan 50 000 000 ₸ gacha |
Ko‘proq kerak bo‘lsa, Telegram’da yozing — limitni oshiramiz.