teamver-sdk-core

Shared async HTTP core for Teamver Python SDKs: transport, unified errors, retry, request context, pagination, and secret masking.

Used by teamver-mail-agent, teamver-agent-sdk, and other Teamver packages.

변경 이력

Install

pip install teamver-sdk-core

Python ≥ 3.11.

Quick start

import asyncio
from teamver_sdk_core import (
    TeamverAsyncTransport,
    TransportConfig,
    RequestContext,
    TeamverSDKError,
)

async def main():
    config = TransportConfig(base_url="https://api.teamver.com", token="tv_ak_…")
    async with TeamverAsyncTransport(config) as transport:
        ctx = RequestContext(workspace_id="WS-…")
        try:
            resp = await transport.request("GET", "/api/v2/collab/channels", context=ctx)
            print(resp.json)
        except TeamverSDKError as exc:
            print(exc.code, exc.status_code, exc.request_id)

asyncio.run(main())

Features

Default API hosts (SSOT)

No path suffix (/api, /v1). Override per package via env.

Error tree

TeamverSDKError
├─ ConfigurationError
├─ AuthenticationError        (401)
├─ AuthorizationError         (403)
├─ NotFoundError              (404)
├─ ConflictError              (409)
│  ├─ IdempotencyConflictError
│  └─ VersionConflictError
├─ RateLimitError             (429)
├─ TemporaryUnavailableError  (502/503/504)
└─ TransportError

Retry rules

• Retried: transport failure, 429, 502, 503, 504
• GET/HEAD/PUT/DELETE — treated as idempotent
• POST/PATCH — retried only when idempotency_key is set

Documentation

Public docs: github.com/NeuralStudioKr/teamver-sdk-docs/tree/main/sdk-core

Development

pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.