Metadata-Version: 2.4
Name: dataxapi
Version: 0.2.0
Summary: DataXAPI Python SDK: exact public social data endpoints with one CNY balance
Author-email: "DataXAPI (Aurevant LLC)" <support@dataxapi.com>
License-Expression: MIT
Project-URL: Homepage, https://dataxapi.com
Project-URL: Documentation, https://dataxapi.com/en/apis/
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# DataXAPI Python SDK（内部 Preview）

该包由当前 Catalog Release／OpenAPI 生成 `TypedDict` 输入、输出、错误和样例；运行时只负责认证、超时、同一逻辑调用的幂等重试、分页和 Usage。它不包含 Provider、价格判断或接口选择逻辑。

```python
import os
from dataxapi import ExactApiClient

client = ExactApiClient(
    os.environ["DATAXAPI_API_BASE_URL"],
    os.environ["DATAXAPI_API_KEY"],
)
result = client.x.posts.search({"query": "OpenAI min_faves:100"})
print(result["data"]["items"], result["meta"]["charged_amount"])
```

`timeout` 限制每次网络尝试的总时长，覆盖响应头和正文。SDK 只自动等待不超过该值的合法重试间隔；更长或无效的服务端间隔会直接返回原 `ExactApiError`，由调用方决定何时重试。错误保留 `retry_after_ms`／`retry_after` 和 `idempotency_key`；恢复同一次调用时必须复用该 Key。合法的正文间隔优先于 `Retry-After`，每次调用最多进行 `max_retries + 1` 次尝试。

当前仍使用内部包名并带有 `Private :: Do Not Upload` 分类。正式 PyPI 发布账户与包名尚未签收；本文内部包示例不代表已经可以从公开 Registry 安装。
