chore: update README with platform list, examples, error handling, and documentation links

Author: Anonymous Committer

README.md

@@ -5,9 +5,9 @@
 
 # Just One API - Python SDK
 
-Official Python SDK for accessing [Just One API](https://justoneapi.com).
+Official Python SDK for accessing [Just One API](https://justoneapi.com) - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
 
-Version 2 is generated from the public OpenAPI document and covers the full `public-api` surface. The SDK now returns typed response objects instead of tuples.
+Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the [official website](https://justoneapi.com).
 
 ## Installation
 
@@ -21,12 +21,14 @@ pip install justoneapi
 from justoneapi import JustOneAPIClient
 
 client = JustOneAPIClient(token="your_token")
-response = client.douyin.get_video_detail_v2(video_id="7428906452091145483")
 
-print(response.success)
-print(response.code)
-print(response.message)
-print(response.data)
+# Example: Douyin video search
+response = client.douyin.search_video_v4(keyword="deepseek")
+
+print(response.success)  # True only when code == 0
+print(response.code)     # Business code returned by the API
+print(response.message)  # Server message
+print(response.data)     # Actual payload
 ```
 
 ## Response Shape
@@ -41,18 +43,58 @@ Every API method returns an `ApiResponse` instance with these fields:
 | `data` | `Any` | Response payload from the API. |
 | `raw_json` | `dict` | Full response payload before SDK normalization. |
 
+## Error Handling
+
+By default, business failures do not raise exceptions. You can check `response.success`, `response.code`, and `response.message`.
+
+If you prefer exceptions for non-zero business codes:
+
+```python
+from justoneapi import JustOneAPIClient, BusinessError
+
+client = JustOneAPIClient(
+    token="your_token",
+    raise_on_business_error=True,
+)
+
+try:
+    response = client.douyin.search_video_v4(keyword="deepseek")
+except BusinessError as exc:
+    print(exc.response.code)
+    print(exc.response.message)
+```
+
 ## Authentication
 
 All API requests require a valid API token.
 
-## OpenAPI Sync
+Register here:
 
-The repository ships scripts for the generation pipeline:
+- [Get API Token](https://dashboard.justoneapi.com/en/register)
 
-```bash
-python3.11 scripts/fetch_openapi.py
-python3.11 scripts/normalize_openapi.py
-python3.11 scripts/generate_sdk.py
-```
+## Documentation
+
+Full API documentation:
+
+- [API Documentation](https://docs.justoneapi.com/en)
+
+The documentation includes:
+
+- Request parameters
+- Response fields
+- Error codes
+- Platform-specific examples
+
+## Official Website
+
+- [Home Page](https://justoneapi.com)
+
+## Contact
+
+If you have questions, feedback, or partnership inquiries:
+
+- [Contact Us](https://justoneapi.com/en/contact)
+
+## License
 
-`fetch_openapi.py` reads credentials from `OPENAPI_BASIC_AUTH_USERNAME` and `OPENAPI_BASIC_AUTH_PASSWORD` by default.
+This project is licensed under the MIT License.

README.zh-CN.md

@@ -7,7 +7,9 @@
 
 官方 Python SDK，用于访问 [Just One API](https://justoneapi.com/zh/)。
 
-2.x 版本改为基于公开 OpenAPI 文档自动生成，覆盖完整 `public-api` 接口面，返回值也改为 `ApiResponse` 对象，不再返回 tuple。
+Just One API 是一个统一的数据服务平台，提供来自社交媒体、电商和内容平台的结构化数据。
+
+支持的平台包括淘宝、天猫、小红书、小红书蒲公英、抖音、抖音星图、快手、微博、哔哩哔哩、京东、微信、豆瓣、TikTok、TikTok Shop、优酷、Instagram、YouTube、Reddit、头条、知乎、亚马逊、Facebook、X(Twitter)、贝壳、IMDb 等接口。想了解更多，可以访问[官网](https://justoneapi.com/zh/)。
 
 ## 安装
 
@@ -21,12 +23,14 @@ pip install justoneapi
 from justoneapi import JustOneAPIClient
 
 client = JustOneAPIClient(token="your_token")
-response = client.douyin.get_video_detail_v2(video_id="7428906452091145483")
 
-print(response.success)
-print(response.code)
-print(response.message)
-print(response.data)
+# 示例：搜索抖音视频
+response = client.douyin.search_video_v4(keyword="deepseek")
+
+print(response.success)  # 仅当 code == 0 时为 True
+print(response.code)     # 服务端返回的业务码
+print(response.message)  # 服务端消息
+print(response.data)     # 实际业务数据
 ```
 
 ## 返回结构
@@ -41,14 +45,58 @@ print(response.data)
 | `data` | `Any` | API 返回的业务数据。 |
 | `raw_json` | `dict` | SDK 处理前的完整 JSON 响应。 |
 
-## OpenAPI 同步
+## 错误处理
 
-仓库内置了生成链路脚本：
+默认情况下，业务失败不会抛异常，你可以通过 `response.success`、`response.code` 和 `response.message` 自行判断。
 
-```bash
-python3.11 scripts/fetch_openapi.py
-python3.11 scripts/normalize_openapi.py
-python3.11 scripts/generate_sdk.py
+如果你希望业务失败时直接抛异常：
+
+```python
+from justoneapi import JustOneAPIClient, BusinessError
+
+client = JustOneAPIClient(
+    token="your_token",
+    raise_on_business_error=True,
+)
+
+try:
+    response = client.douyin.search_video_v4(keyword="deepseek")
+except BusinessError as exc:
+    print(exc.response.code)
+    print(exc.response.message)
 ```
 
-默认会从环境变量 `OPENAPI_BASIC_AUTH_USERNAME` 和 `OPENAPI_BASIC_AUTH_PASSWORD` 读取 swagger 的 Basic Auth 凭据。
+## 身份认证
+
+所有 API 请求都需要有效的 API Token。
+
+注册链接：
+
+- [注册获取 Token](https://dashboard.justoneapi.com/zh/register)
+
+## 文档中心
+
+完整接口文档：
+
+- [API 文档](https://docs.justoneapi.com/zh)
+
+文档中包含：
+
+- 请求参数说明
+- 返回字段说明
+- 错误码说明
+- 各平台调用示例
+
+## 官方网站
+
+- [官方网站](https://justoneapi.com/zh/)
+
+## 联系我们
+
+如果你有任何问题、反馈或合作需求：
+
+- [联系我们](https://justoneapi.com/zh/contact)
+
+## 许可证
+
+本项目基于 MIT License 发布。