Python over HTTP

A complete example using Python's standard library, with no separate SDK.

Prepare the input

Save request.json from the first-request page. Supply SHVYDKO_BASE_URL and SHVYDKO_API_KEY through the server process environment. The example uses json, os, and urllib.request from the standard library.

Copy request.json

Request, status, and response

This example deliberately does not retry POST automatically. Add your own bounded retry mechanism after considering the HTTP status and risk of duplicate processing.

request.py · Python 3

import json
import os
import urllib.error
import urllib.request

base_url = os.environ["SHVYDKO_BASE_URL"].rstrip("/")
api_key = os.environ["SHVYDKO_API_KEY"]
with open("request.json", encoding="utf-8") as source:
    payload = json.load(source)

request = urllib.request.Request(
    base_url + "/v1/systemone",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + api_key,
        "Content-Type": "application/json",
        "User-Agent": "ShvydkoClient/1.0",
    },
    method="POST",
)

try:
    with urllib.request.urlopen(request, timeout=150) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    # Do not log the API key or the original customer context.
    try:
        detail = json.loads(error.read()).get("detail", "Request failed")
    except (ValueError, AttributeError):
        detail = "Non-JSON error response"
    retry_after = error.headers.get("Retry-After")
    raise SystemExit(
        f"Shvydko HTTP {error.code}: {detail}; Retry-After={retry_after}"
    )
except (urllib.error.URLError, TimeoutError) as error:
    raise SystemExit(
        "Network failure; check Usage before repeating a paid request"
    ) from error

print("request_id:", result["request_id"])
print("team:", result["answers"]["team"]["choice"])
print("input_tokens:", result["usage"]["input_tokens"])
print("cost_usd:", result["usage"]["cost_usd"])

Connecting to your application

Keep the secret in the server environment, separately for each development environment.
Pass only validated fields and allowed categories to business logic.
Limit concurrency according to the organization's quota.
Associate request_id with your task ID without logging secrets.

This is a direct Shvydko HTTP client. It does not claim a separate official Python SDK or compatibility with all third-party SDKs.