База знања

Коришћење Python SDK-а (zinn-sdk)

Инсталирајте zinn-sdk са PyPI-ја, направите API кључ и позивајте Zinn Digital® API из језика Python — јавне регионе без кључа, затим сопствене сајтове — као и где се свака операција налази под zinn_sdk.api и синхроне, асинхроне и детаљне варијанте.

Zinn®, наш викинг, чита своју контролну листу поред индекса чланака са једним отвореним.

zinn-sdk је наш званични Python клијент за Zinn Digital® API, објављен на PyPI-ју и увезен као zinn_sdk. Генерише се из исте OpenAPI спецификације на основу које је изграђен и сам API, свака операција има синхроне и asyncio варијанте, а нова верзија се објављује аутоматски кад год се спецификација промени. Овај водич га инсталира, аутентикује и обавља ваше прве позиве.

Инсталација

pip install zinn-sdk

Захтева Python 3.11 или новији и под MIT лиценцом је.

Направите API кључ

Отворите страницу API кључеви на својој контролној табли (app.zinndigital.com/api-keys) и притисните Направите кључ. Доделите кључу назив и само оне дозволе које су потребне вашем коду — на пример sites.view за приказ листе сајтова. Кључ се приказује само једном; сачувајте га у променљивој окружења или у свом складишту тајни, никада у изворном коду. Кључ можете опозвати у било ком тренутку на истој страници.

Јавне крајње тачке каталога, као што су региони хостовања и пакети, уопште не захтевају кључ.

Ваши први позиви

import os

from zinn_sdk import AuthenticatedClient, Client
from zinn_sdk.api.catalog import list_public_hosting_regions
from zinn_sdk.api.hosting import list_sites

# Public catalogue endpoints need no key.
public = Client(base_url="https://api.zinndigital.com")
regions = list_public_hosting_regions.sync(client=public)
print([region.slug for region in regions.data])

# Everything else uses a per-organisation API key.
api = AuthenticatedClient(base_url="https://api.zinndigital.com", token=os.environ["ZINN_API_KEY"])
page = list_sites.sync(client=api, limit=5)
for site in page.data:
    print(site.name, site.status)

Проналажење операције

Операције су груписане по областима API-ја у оквиру zinn_sdk.api и назване према њиховом идентификатору операције у snake case формату. Излиставање сајтова је zinn_sdk.api.hosting.list_sites; домени и DNS су у оквиру zinn_sdk.api.domains; наплата је у оквиру zinn_sdk.api.billing. API документација приказује идентификатор сваке операције.

Синхроно, асинхроно и потпуни одговор

Сваки модул операције има четири функције:

  • sync(...) враћа обрађени модел, или None у случају неочекиваног статуса.
  • sync_detailed(...) враћа Response са вредностима status_code, headers и parsed.
  • asyncio(...) и asyncio_detailed(...) раде исто, али се могу чекати помоћу await.
import asyncio

from zinn_sdk.api.hosting import list_sites


async def main() -> None:
    response = await list_sites.asyncio_detailed(client=api, limit=5)
    print(response.status_code, len(response.parsed.data))


asyncio.run(main())

Користите _detailed варијанте када треба да разликујете 403 (кључу недостаје дозвола) од 404.

Куда даље

  • Водич на нашем веб-сајту: zinndigital.com/developers/sdk-python
  • Свака крајња тачка, њени параметри и њена дозвола: zinndigital.com/developers/api
  • Пакет на PyPI: pypi.org/project/zinn-sdk

Сва документација за програмере →

Најновије са блога

О чему смо писали када је реч о хостингу, SEO-у и вођењу сајтова великих размера.

SEO и изградња линкова са хостинг слоја: поглед оператера за 2026. годину

Како хостинг утиче на индексирање и вредност линкова у 2026. години: одржавање страница индексираним, провера старих домена пре израде сајтова на њима, изградња линкова без отиска (footprint-а) и искрен осврт на то шта инфраструктура може, а шта не може да учини за SEO.

Прочитајте чланак →

Како учинити WordPress брзим и безбедним: Контролна листа за перформансе и прикључке

Практична контролна листа за брз и безбедан WordPress: кеширање на нивоу сервера, кеш објеката по сајту, неколицина додатака вредних коришћења, одржавање стека ажурним и WooCommerce странице које никада не смете кеширати.

Прочитајте чланак →

Како изабрати управљани веб-хостинг у 2026. години: Водич за купце

Шта заправо разликује добар управљани хостинг од јефтиног сервера са контролним панелом — миграције, резервне копије, изолација, право кеширање и поштено скалирање — и како да то процените пре него што се обавежете.

Прочитајте чланак →

Прочитајте блог →

И даље сте заглављени?

Подршка је укључена у сваки план, служба је отворена 24 сата дневно и можете нам писати на било ком од наших 58 језика — одговарамо вам на вашем језику.

Контактирајте подршку Сви чланци