API - Қызметті жасау

Zomro платформасында қызметті тапсырыс беру процесінде бірнеше маңызды кезеңдерге назар аудару қажет: қызметті себетке қосу, промокодты белсендіру (бар болса) және қызметті сатып алу. Бұл қадамдар тапсырыс беру кезінде промокодтардың функционалын тиімді пайдалануға мүмкіндік береді. Тапсырыс беру үшін қызметтің белгілі параметрлерін беру қажет, олардың егжей-тегжейлері төменде көрсетілген.

Тапсырыс жасау процесі келесі кезеңдерден тұрады:

• Қызметті себетке қосу
• Промокодты белсендіру
• Себеттен қызметті сатып алу

Дәл осындай сатып алу кезеңдерін пайдалану тапсырыс беру кезінде промокодты пайдалануға мүмкіндік береді.

Тапсырыс жасау үшін бізді қызықтыратын қызмет параметрлерін беру қажет. Қол жетімді параметрлерді қалай алуға болатыны мұнда сипатталған. 

Cloud VPS Zomro қызметін тапсырыс беру үшін сұраныс құрылымы:
 

URL: 

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):
 

Қызметті тапсырыс беру мысалы

Мысал ретінде, Linux Ubuntu 20.04 операциялық жүйесі бар Cloud Essential тарифін, тек IPv6 серверімен және root пайдаланушысының паролін пайдаланып алайық.

URL: 

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

Міне, консольдан орындауға болатын сұраныс мысалы:

curl --location 'https://api.zomro.com/' \
--form 'func="v2.instances.order.param"' \
--form 'auth="211a9ac6309a9f0c340bdebf"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'order_period="-50"' \
--form 'licence_agreement="on"' \
--form 'use_ssh_key="off"' \
--form 'pricelist="6740"' \
--form 'servername="MyServer-1"' \
--form 'password="Mypassword1"' \
--form 'instances_os="479c96f1-ccc6-47a2-952c-c9e3bbdc8d07"' \
--form 'order_count="1"' \
--form 'addon_6746="260"' \
--form 'datacenter="13"' \
--form 'force_use_new_cart="on"'

Сұранысты орындағаннан кейін, бізге келесі деңгейде орналасқан деректер қажет:

doc

Сұранысты орындау нәтижесінде алынған мәндер:

...,

"lineitem.id": {
    "$": "1818"
},
...

Бұл "1818" мәні, себеттегі тапсырыс нөмірі, қызметті белсендіру үшін қажет. Оны әрі қарай пайдалану үшін есте сақтаймыз.

Бұл сұранысты орындағаннан кейін, себетте бар өнімді де көруге болады.

Келесі кезең - егер промокод болса, оны белсендіру. Бұл кезең міндетті емес, бірақ егер клиентте промокод болса, оны пайдалануға мүмкіндік болғаны жақсы.

URL: 

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

Міне, консольдан орындауға болатын сұраныс мысалы:

curl --location 'https://api.zomro.com/' \
--form 'out="json"' \
--form 'auth="46ffb314c8d46ec1f2f1df16"' \
--form 'func="cart"' \
--form 'promocode="PROMO_2024"' \
--form 'sok="ok"' \
--form 'clicked_button="apply_promocode"'

Бұл сұранысты орындағаннан кейін, себетте промокодты белсендіру нәтижесін көруге болады:

Суретте промокод PROMO_2024 сәтті белсендіріледі. 
PS: Шын мәнінде, промокод PROMO_2024 сіздің жағдайыңызда жарамсыз, ол тек осы нұсқаулықты жазу үшін жасалған.

Келесі кезең - қызметті белсендіру.

Егер промокод 100% жеңілдік бермесе, қызметті жеке кабинеттен қосымша төлеу қажет. 

Егер промокод 100% қызмет құнын жабатын болса, API сұранысы келесідей болады:

 URL: 

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

Міне, консольдан орындауға болатын сұраныс мысалы:

curl --location 'https://api.zomro.com/' \
--form 'out="json"' \
--form 'auth="cd63c7832f0ae5947c49ac06"' \
--form 'func="cartorder.create.confirm"' \
--form 'sok="ok"' \
--form 'elid="1818"' \
--form 'paymethod_id="0"'

Бұл сұранысты орындағаннан кейін, себетте бұл қызмет болмауы керек, CloudVPS қызметтерінің жалпы тізімінде біздің қызметіміз "Активация процесінде" статусымен көрінеді:

Қызметті белсендіру процесінде қосымша әрекеттер болмайды. Қызмет белсендірілгеннен кейін, бізге қызметтерді басқару үшін қол жетімді әрекеттер тізімі ашылады, мысалы: Бастау, Тоқтату, Жою, Өлшемін өзгерту және басқалар.
 

Сондай-ақ, API арқылы Cloud VPS өнімдерімен өзара әрекеттесу үшін пайдалы болуы мүмкін мақалаларды зерттеуді ұсынамыз:

• API - Қол жетімді тарифтер мен олардың параметрлері туралы ақпарат алу
• API - Бастау & Тоқтату операциясы
• API - Қайта жүктеу операциясы
• API - Қайта құру операциясы
• API - Жою операциясы
• API - Image-пен өзара әрекеттесу
• API - Резервтік көшірме кестесімен өзара әрекеттесу
• API - Rescue-пен өзара әрекеттесу
• API - Резервтік көшірмемен өзара әрекеттесу
• API - Snapshot-пен өзара әрекеттесу
• API - ISO-дан жүктеумен өзара әрекеттесу