КІРУ
    opened image

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

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

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

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

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

     

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

    URL: 

    https://api.zomro.com/

    Әдіс: POST

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

    Параметр Мәннің мысалы Міндетті параметр Мәннің сипаттамасы
    func v2.instances.order.param Иә Қызметке тапсырыс беру функциясы
    auth 21fc199...c43f71 Жоқ Сессия токені. Бұл авторизацияның бір нұсқасы. Қандай басқа нұсқалар бар екендігі туралы толығырақ мұнда сипатталған
    out json Жоқ API-ден жауапты қандай форматта күту керек
    sok ok Иә Операцияны растау
    order_period -50 Иә cloudvps қызметтері үшін сағаттық төлем қолданылады. Сағаттық төлеммен қызметті сатып алу үшін -50 мәні қолданылады
    licence_agreement on Иә Пайдалану лицензиясымен келісу
    pricelist 6740 Иә Тапсырыс беру қажет тарифтің ID. Тарифтің ID-ін v2.instances.order.pricelist функциясынан алуға болады. Қалай пайдалану керектігі туралы толығырақ мұнда сипатталған
    order_count 1 Иә Бір сұрауда тапсырыс беруге болатын қызметтердің саны
    force_use_new_cart on Иә Қызметті жаңа billmanager себетіне қосу
    instances_ssh_keys 490 Жоқ ОЖ орнатқаннан кейін серверге қосу қажет SSH кілтінің ID. use_ssh_key=off параметрі берілмесе, берудің қажеті жоқ
    password Mypassword1 Жоқ Серверге кіру паролі. Linux жағдайында - root пайдаланушының паролі. Windows жағдайында - Administrator пайдаланушының паролі. use_ssh_key=on параметрі берілмесе, берудің қажеті жоқ.
    Сондай-ақ, парольде кем дегенде 1 бас әріп, 1 сандық символ болуы керек, ең аз таңбалар саны 8.  
    servername MyServer Жоқ Сервердің жеке атауы
    instances_os 18d0ee2e-4d57-4f40-9b56-03c1773b5831 Иә Орнату қажет операциялық жүйенің UID. Операциялық жүйенің UID-ін v2.instances.order.pricelist функциясынан алуға болады. Қалай пайдалану керектігі туралы толығырақ мұнда сипатталған
    use_ssh_key off Жоқ ssh кілтін пайдалану немесе пайдаланбау. off немесе on мәндерін қабылдай алады.
    addon_xxx

    260

    Жоқ Қызметтің қосымша параметрлері. RAM, CPU саны, диск өлшемі, трафик көлемі, IPv4 немесе IPv6 түрі болуы мүмкін. Қолжетімді параметрлер тарифке байланысты. Қандай опциялар қолжетімді екенін білу үшін мұнда сипатталған мысалды қараңыз

     

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

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

    URL: 

    https://api.zomro.com/

    Әдіс: POST

     

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

    Параметр Мән
    func v2.instances.order.param
    auth 21fc199...c43f71
    out json
    sok ok
    order_period -50
    licence_agreement on
    pricelist

    6740

    order_count 1
    password MyPassword1
    servername MyServer-1
    instances_os

    479c96f1-ccc6-47a2-952c-c9e3bbdc8d07

    use_ssh_key off

    addon_6746

    260

    force_use_new_cart on

     

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

    curl --location 'https://api.zomro.com/' \
    --form 'func="v2.instances.order.param"' \
    --form 'auth="211a9ac6309a9f0c340bdebf"' \
    --form 'out="json"' \
    --form 'sok="on"' \
    --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 'force_use_new_cart="on"'

     

    Бұл сұрауды орындағаннан кейін бізге келесі иерархиядағы деректер қажет:

    doc

     

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

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

     

     

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

     

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


     

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

    URL: 

    https://api.zomro.com/

    Әдіс: POST

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

    Параметр Мәннің мысалы Міндетті параметр Мәннің сипаттамасы
    func cart Иә Себетпен жұмыс істеу функциясының атауы
    auth 21fc199...c43f71 Жоқ Сессия токені. Бұл авторизацияның бір нұсқасы. Қандай басқа нұсқалар бар екендігі туралы толығырақ мұнда сипатталған
    out json Жоқ API-ден жауапты қандай форматта күту керек
    sok ok Иә Операцияны растау
    promocode PROMO_2024 Иә Пайдалануды жоспарлаған промокод. 
    clicked_button apply_promocode Иә Промокодты белсендіруді растау

     

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

    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):

    Параметр Мәннің мысалы Міндетті параметр Мәннің сипаттамасы
    func cartorder.create.confirm Иә Себетпен жұмыс істеу функциясы
    auth 21fc199...c43f71 Жоқ Сессия токені. Бұл авторизацияның бір нұсқасы. Қандай басқа нұсқалар бар екендігі туралы толығырақ мұнда сипатталған
    out json Жоқ API-ден жауапты қандай форматта күту керек
    sok ok Иә Операцияны растау
    elid 1818 Иә Тапсырыс ID. Бұл мән қызметті себетке қосу кезінде алынған
    paymethod_id 0 Иә Төлем әдісінің ID. 0 мәні стандартты болып табылады және тапсырысты жеке шоттағы қаражат есебінен төлеу әдісіне сәйкес келеді

     

     

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

     

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

     

     

    Бұл сұрауды орындағаннан кейін, себетте бұл қызмет болмауы керек, CloudVPS қызметтерінің жалпы тізімінде біздің қызметімізді "Activation in progress" күйінде көреміз:

     

     

    Қызметті белсендіру процесінде қызметпен қосымша әрекеттер жоқ. Қызмет белсендірілгеннен кейін, бізде қызметтерді басқару үшін қолжетімді әрекеттер тізімі ашылады, мысалы: Start, Stop, Delete, Resize және басқалар.
     

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