Metadata-Version: 2.4
Name: open-sdk-py
Version: 2.2.0
Summary: 云枢开放服务平台集成SDK工具（Python版）
Project-URL: Homepage, https://open.yljr.com
Project-URL: Repository, https://github.com/anomalyco/open-sdk-py
Author-email: CynicalHeart <wutianyu@yljr.com>
License: MIT
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: certifi>=2024
Requires-Dist: cryptography>=42
Requires-Dist: requests<3,>=2.28
Description-Content-Type: text/markdown

## 云枢开放平台Python版工具使用

> 调用云枢开放平台接口集成工具，支持RSA数据加密，请求业务接口可集成到客户端系统中

### 1. 安装与使用

Python 版本要求：>=3.11

```bash
# pip 安装
pip install open-sdk-py

# uv 安装
uv add open-sdk-py
```

### 2. 使用

```python
from open_sdk_py import OpenPlatformClient

# 建立请求云枢客户端
client = OpenPlatformClient.create(
    app_key="企业端key值",
    app_secret="企业端secret值",
    request_url="企业申请能力接口，通过后可在申请详情获取接口地址",
    request_data=data,  # 请求数据，推荐dict格式或json格式
    headers={},         # 【若有】dict类型，包含请求头键值对
)

# 发送请求
result = client.send()  # type为dict类型
```

也可以采用链式构建客户端：

```python
client = OpenPlatformClient.create(
    app_key="企业端key值",
    app_secret="企业端secret值",
    request_url="企业申请能力接口，通过后可在申请详情获取接口地址",
).set_request_data({}).set_headers({})

result = client.send()
```

### 3. 错误码

| 错误编码 | 错误信息（含义） |
|:---:|:---:|
| M0411 | `app_key`、`app_secret`和`request_url`是必填参数，不能为空 |
| M0429 | 请求次数过多，请稍后重试 |
| M0430 | 不支持的请求类型 |
| M0500 | 系统繁忙，请稍后重试 |
| M0555 | 参数校验失败 |
| M0511 | 三方服务调用失败 |
| M0512 | 获取接口信息失败 |
| M0513 | 响应信息转换失败 |
| M0514 | 接口请求参数不能为空 |
| M0515 | 接口请求头不能为空 |
| REQUEST_TIMEOUT | 请求超时 |
| CONNECTION_ERROR | 网络连接失败 |
| HTTP_{code} | HTTP 状态码异常（如 HTTP_403、HTTP_502） |
| PARSE_ERROR | 响应 JSON 解析失败 |

### 补充

---

云枢开放平台地址：[**https://open.yljr.com**](https://open.yljr.com)

问题反馈联系方式：***open-api@yljr.com***
