API - Informacijos apie galimus tarifus ir jų parametrus gavimas

Norėdami dirbti su Cloud VPS paslaugomis per API, Zomro suteikia patogią sąsają, leidžiančią gauti informaciją apie galimus tarifus. Naudodami funkciją v2.instances.order.pricelist galite gauti visą tarifų sąrašą su trumpu aprašymu ir kainomis. Tada, naudodami funkciją v2.instances.order.param, nurodydami tarifo ID ir užsakymo laikotarpį, galite gauti išsamią pasirinkto tarifo informaciją. Žemiau pateikiami užklausų pavyzdžiai ir atsakymų struktūra kiekvienai funkcijai. Ši informacija padės efektyviai valdyti jūsų debesų serverius per Zomro API.

Norėdami gauti visus galimus tarifus Cloud VPS paslaugai, galite naudoti šią funkciją:

v2.instances.order.pricelist

Užklausos struktūra:
URL:

https://api.zomro.com/

Užklausos metodas: POST
Užklausos turinys (form-data):

Parametras	Pavyzdinė vertė	Vertės aprašymas
func	v2.instances.order.pricelist	Funkcija, skirta gauti galimus užsakymo tarifus
auth	21fc199...c43f71	Sesijos žetonas. Tai vienas iš autorizacijos būdų. Daugiau apie kitus būdus aprašyta čia
out	json	Atsakymo struktūra, kurios tikėtis

Štai užklausos pavyzdys, kurį galima atlikti iš konsolės:

curl --location 'https://api.zomro.com/' \
--form 'func="v2.instances.order.pricelist"' \
--form 'auth="19c8130ac494a5e7c162d246"' \
--form 'out="json"'

Po užklausos atlikimo, mums reikalingi duomenys, kurie yra šioje struktūroje:

doc.list.elem

Štai vieno iš gautų elementų pavyzdys:

...,
{
"buttons": {
    "button": {
        "$name": "order",
        "$type": "func",
        "$key": "pricelist",
        "$theme": "primary",
        "$func": "v2.instances.order.param"
    }
},
"description": {},
"detail": [
    {
        "name": {
            "$": "network"
        },
        "value": {
            "$": "IPv4 NL-2"
        }
    },
    {
        "name": {
            "$": "CPU count"
        },
        "value": {
            "$": "1"
        }
    },
    {
        "name": {
            "$": "Memory"
        },
        "value": {
            "$": "2 Gb"
        }
    },
    {
        "name": {
            "$": "Disk space"
        },
        "value": {
            "$": "12 Gb"
        }
    },
    {
        "name": {
            "$": "Port speed"
        },
        "value": {
            "$": "1 Gbit/s."
        }
    },
    {
        "name": {
            "$": "Bandwidth"
        },
        "value": {
            "$": "Unmetered traffic"
        }
    }
],
"flabel": {
    "tag": [
        {
            "$": "72866a3690e44679070d48b8ffa2c963"
        },
        {
            "$": "a362f6fd19c99d07441692bf4cce537c"
        }
    ]
},
"id": {
    "$": "6740"
},
"pricelist": {
    "$": "6740"
},
"prices": {
    "$key": "period_6740",
    "price": {
        "$special_price": "no",
        "cost": {
            "$": "0.13"
        },
        "currency": {
            "$": "EUR"
        },
        "period": {
            "$": "-50"
        }
    }
},
"title": {
    "$": "Cloud Essential"
}
},
...

Turėdami šiuos duomenis, galite sužinoti tarifo ID. Mūsų atveju vertė yra "6740", ir trumpą informaciją apie tarifą. Norėdami gauti išsamią informaciją apie tarifą, turite naudoti funkciją:

v2.instances.order.param

ir tarifo ID bei užsakymo laikotarpį.

Užklausos struktūra:

URL:

https://api.zomro.com/

Užklausos metodas: POST
Užklausos turinys (form-data):

Parametras	Pavyzdinė vertė	Vertės aprašymas
func	v2.instances.order.param	Funkcija, skirta gauti papildomus duomenis apie tarifą
auth	21fc199...c43f71	Sesijos žetonas. Tai vienas iš autorizacijos būdų. Daugiau apie kitus būdus aprašyta čia
out	json	Atsakymo struktūra, kurios tikėtis
order_period	-50	Laikotarpis, kuriam galima užsakyti paslaugą
pricelist	6740	Paslaugos ID, kurią reikia užsakyti

Štai užklausos pavyzdys, kurį galima atlikti iš konsolės:

curl --location 'https://api.zomro.com/' \
--form 'func="v2.instances.order.param"' \
--form 'auth="579ea10f7790f5e7de91357c"' \
--form 'out="json"' \
--form 'order_period="-50"' \
--form 'pricelist="6740"'

Po užklausos atlikimo, mums reikalingi duomenys, kurie yra šioje struktūroje:

doc.slist

Štai vertės, gautos atlikus užklausą:

{
"$name": "instances_os",
"val": [
    {
        "$key": "18d0ee2e-4d57-4f40-9b56-03c1773b5831",
        "$": "AlmaLinux 8"
    },
    {
        "$key": "5da4ad83-45f6-4c0e-9a7e-7a7c18b2be6c",
        "$": "AlmaLinux 9"
    },
    {
        "$key": "3d9d9db6-325a-4d91-9bdb-6c48ad291cb6",
        "$": "CentOS Stream 8"
    },
    {
        "$key": "7d7911e3-7178-4f36-a308-d841db5fe654",
        "$": "CentOS Stream 9"
    },
    {
        "$key": "0bf4deb2-855c-4863-8518-6006d804adbb",
        "$": "Debian 10"
    },
    {
        "$key": "3010ae60-0185-4021-98da-f50013147ebd",
        "$": "Debian 11"
    },
    {
        "$key": "93878ba5-6b9e-4924-a4be-34edb623f808",
        "$": "Debian 12"
    },
    {
        "$key": "1d9dda4c-34b0-4304-a90a-8f3018722fa2",
        "$": "Rocky-Linux-8"
    },
    {
        "$key": "a8b7bcb3-6698-4264-b413-f2b866a46a70",
        "$": "Rocky-Linux-9"
    },
    {
        "$key": "479c96f1-ccc6-47a2-952c-c9e3bbdc8d07",
        "$": "Ubuntu 20.04"
    },
    {
        "$key": "f8f2573f-56c4-44c5-8469-84eee4aa64e7",
        "$": "Ubuntu 22.04"
    },
    {
        "$key": "92fabac2-69cc-46ad-8439-c377e0c90632",
        "$": "Ubuntu 23.04"
    },
    {
        "$key": "6f8476f9-93f0-4ddd-b0fd-624e930ffacd",
        "$": "Ubuntu 23.10"
    }
]
},
{
"$name": "addon_6746",
"val": [
    {
        "$key": "259",
        "$": "IPv4 NL-2 (0.04 EUR)"
    },
    {
        "$key": "260",
        "$": "IPv6 NL-2 (0.00 EUR)"
    }
]
},
{
"$name": "addon_6745",
"val": [
    {
        "$key": "58",
        "$": "1 (0.00 EUR)"
    }
]
},
{
"$name": "addon_6744",
"val": [
    {
        "$key": "42",
        "$": "2 Gb (0.00 EUR)"
    }
]
},
{
"$name": "addon_6743",
"val": [
    {
        "$key": "143",
        "$": "12 Gb (0.00 EUR)"
    }
]
},
{
"$name": "addon_6742",
"val": [
    {
        "$key": "246",
        "$": "1 Gbit/s. (0.00 EUR)"
    }
]
},
{
"$name": "addon_6741",
"val": [
    {
        "$key": "244",
        "$": "Unmetered traffic (0.00 EUR)"
    }
]
},
{
"$name": "order_period",
"val": [
    {
        "$msg": "yes",
        "$key": "-50",
        "$": "Day"
    }
]
},
{
"$name": "instances_ssh_keys",
"val": [
    {
        "$key": "283",
        "$": "new"
    },
    {
        "$key": "471",
        "$": "111"
    },
    {
        "$key": "490",
        "$": "1115"
    }
]
}

Šis įrašas pateikia šiuos duomenis:

Parametro pavadinimas	Parametro aprašymas
instances_os	Galimos OS, kurias galima įdiegti šiam tarifui
addon_6746	Kokio tipo IP naudoti. Jei pasirinksite tik IPv6, IPv4 nebus suteiktas serveriui. Pasirinkus IPv4, bus suteiktas tiek IPv6, tiek IPv4. Paslaugos kaina tuo atveju padidės.
addon_6745	CPU kiekis, kurį galima užsakyti
addon_6744	RAM kiekis, kurį galima užsakyti
addon_6743	Disko vietos dydis serveryje
addon_6742	Interneto srauto pralaidumo greitis serveryje
addon_6741	Interneto srauto kiekio apribojimas serveryje
order_period	Galimi paslaugos apmokėjimo laikotarpiai
instances_ssh_keys	SSH raktai, kurie pridėti asmeniniame kabinete

Naudodami šiuos parametrus, galite užsakyti paslaugą.

Taip pat siūlome susipažinti su straipsniais, kurie gali būti naudingi dirbant su Cloud VPS produktais per API: