API va autentifikatsiya

Sitora bitta serverda toʻrtta API oilasini yuritadi. Ular bir xil sxema tartibiga va bir xil tamoyilga — jarayon haqiqati server tomonida hisoblanadi — amal qiladi, lekin har birining oʻz subyekt turi bor va ulardan ikkitasi ommaviy.

Ilova APIʼsi

Sitora, Sitora Pro va Sitora Biz ilovalari foydalanadi. Bu shartnomalar ilovalar ichida yetkaziladi va tashqi integratsiya uchun chop etilmaydi — ular har qanday ilova relizida oʻzgarishi mumkin.

Konsol APIʼsi

Ichki administratsiya yuzasi boʻlgan Sitora Console foydalanadi. Sitora xodimlari uchun ajratilgan. Chop etilmaydi.

Robotics API — ommaviy

/api/robotics/v1/ — sertifikatlangan robot parki kontrollerlari unga toʻgʻridan-toʻgʻri integratsiya qiladigan yuza. U URL orqali versiyalanadi, v1 ichida faqat qoʻshimchalar bilan kengayadi va Robotics API boʻlimida toʻliq hujjatlashtirilgan.

• Autentifikatsiya: Authorization: Bearer sit_rk_<key> — restoran egasi bergan, filialga bogʻlangan robot hisob maʼlumoti. Bu hisob maʼlumoti mashina subyekti: u foydalanuvchi emas, aʼzoligi yoʻq va xodimlar jarayonlarida hech qachon harakat qila olmaydi.
• Aniqlash: mashina oʻqiy oladigan shartnoma autentifikatsiyasiz, GET /api/robotics/v1/openapi.json manzilida jonli beriladi. Ushbu saytdagi API reference boʻlimi aynan oʻsha hujjatdan generatsiya qilinadi.

Payment Device API — ommaviy

/api/payments/v1/ — roʻyxatdan oʻtgan toʻlov qurilmalari integratsiya qiladigan yuza: smart kassa hamrohlari va mehmonga qaragan ekranlar. U robototexnika yuzasi bilan bir xil shartlarda URL orqali versiyalanadi va Payment Device API boʻlimida toʻliq hujjatlashtirilgan.

• Autentifikatsiya: Authorization: Bearer sit_pd_<key> — restoran egasi bergan bir martalik ulanish kodini ishlatib qurilma bir marta oladigan hisob maʼlumoti. Robot hisob maʼlumoti kabi bu ham mashina subyekti, va uning ortidagi filial hamda kassa chaqiruvchi tomonidan yuborilmaydi, balki kalitdan keltirib chiqariladi.
• Aniqlash: mashina oʻqiy oladigan shartnoma autentifikatsiyasiz, GET /api/payments/v1/openapi.json manzilida jonli beriladi.

Ikki ommaviy yuza — bu ikki alohida shartnoma, ikki alohida hisob maʼlumoti bilan. Robot hisob maʼlumoti toʻlov yuzasining hamma joyida rad etiladi, qurilma hisob maʼlumoti esa robototexnika yuzasining hamma joyida.