API - Informācijas iegūšana par pieejamajiem tarifiem un to parametriem

Lai strādātu ar Cloud VPS pakalpojumiem caur API, Zomro nodrošina ērtu saskarni, lai iegūtu informāciju par pieejamajiem tarifiem. Izmantojot funkciju v2.instances.order.pricelist, jūs varat iegūt pilnu tarifu sarakstu ar īsu aprakstu un cenām. Pēc tam, izmantojot funkciju v2.instances.order.param ar tarifu ID un pasūtījuma periodu, varat iegūt detalizētas izvēlētā tarifa īpašības. Zemāk ir sniegti pieprasījumu piemēri un atbildes struktūra katrai no funkcijām. Šī informācija palīdzēs jums efektīvi pārvaldīt jūsu mākoņserverus caur Zomro API.

Lai iegūtu visus pieejamos tarifus Cloud VPS pakalpojumam, varat izmantot šādu funkciju:

v2.instances.order.pricelist

Pieprasījuma struktūra:
URL:

https://api.zomro.com/

Pieprasījuma metode: POST
Pieprasījuma ķermenis (form-data):

Parametrs	Vērtības piemērs	Vērtības apraksts
func	v2.instances.order.pricelist	Funkcija, lai iegūtu pieejamos tarifus pasūtīšanai
auth	21fc199...c43f71	Sesijas tokens. Tas ir viens no autorizācijas veidiem. Vairāk par citiem veidiem aprakstīts šeit
out	json	Atbildes struktūra, kuru sagaidīt

Šeit ir pieprasījuma piemērs, kuru var izpildīt no konsoles:

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

Pēc pieprasījuma izpildes mums ir nepieciešami dati, kas atrodas šādā ligzdojumā:

doc.list.elem

Šeit ir viens no elementiem, kuru saņemam:

...,
{
"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"
}
},
...

Ņemot šos datus, var uzzināt tarifa ID. Mūsu gadījumā vērtība ir "6740", un īsu informāciju par tarifu. Lai iegūtu pilnīgus datus par tarifu, jāizmanto funkcija:

v2.instances.order.param

un tarifa ID un pasūtījuma periods.

Pieprasījuma struktūra:

URL:

https://api.zomro.com/

Pieprasījuma metode: POST
Pieprasījuma ķermenis (form-data):

Parametrs	Vērtības piemērs	Vērtības apraksts
func	v2.instances.order.param	Funkcija, lai iegūtu papildu datus par tarifu
auth	21fc199...c43f71	Sesijas tokens. Tas ir viens no autorizācijas veidiem. Vairāk par citiem veidiem aprakstīts šeit
out	json	Atbildes struktūra, kuru sagaidīt
order_period	-50	Periods, uz kuru var pasūtīt pakalpojumu
pricelist	6740	Pakalpojuma ID, kuru nepieciešams pasūtīt

Šeit ir pieprasījuma piemērs, kuru var izpildīt no konsoles:

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"'

Pēc pieprasījuma izpildes mums ir nepieciešami dati, kas atrodas šādā ligzdojumā:

doc.slist

Šeit ir vērtības, kuras iegūtas pieprasījuma izpildes rezultātā:

{
"$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 ieraksts sniedz šādus datus:

Parametra nosaukums	Parametra apraksts
instances_os	Iespējamās OS, kuras pieejamas uzstādīšanai šim tarifam
addon_6746	Kādu IP tipu izmantot. Ja izvēlas tikai IPv6, IPv4 netiks piešķirts serverim. IPv4 gadījumā tiks piešķirts gan IPv6, gan IPv4. Pakalpojuma izmaksas šajā gadījumā palielināsies.
addon_6745	CPU skaits, kas pieejams pasūtīšanai
addon_6744	RAM daudzums, kas pieejams pasūtīšanai
addon_6743	Diska vietas apjoms serverī
addon_6742	Interneta trafika ātrums serverī
addon_6741	Interneta trafika apjoma ierobežojums serverī
order_period	Pieejamie pakalpojuma apmaksas periodi
instances_ssh_keys	SSH atslēgas, kas pievienotas personīgajā kabinetā

Izmantojot šos parametrus, var izmantot pakalpojuma pasūtīšanai.

Tāpat piedāvājam izpētīt rakstus, kas var būt noderīgi, lai mijiedarbotos ar Cloud VPS produktiem, izmantojot API: