py-tiehu-toolkit

铁虎管理系统 API Python SDK，提供同步和异步两种调用方式，实现完整的请求签名机制，用于与铁虎停车场管理系统（Parking）和 SCMP 进行 API 交互。

功能特性

• ✅ 自动生成请求签名/Token（MD5 算法）
• ✅ 支持同步/异步 HTTP 请求
• ✅ 自动添加公共请求参数
• ✅ Pydantic 响应模型支持
• ✅ JSON Schema 响应校验

项目结构

src/py_tiehu_toolkit/
├── __init__.py          # 模块入口
├── parking/             # 停车场模块
│   ├── __init__.py      # Pklot 客户端类
│   ├── utils.py         # 工具函数
│   └── responses.py     # 响应数据模型
└── scmp/                # SCMP 模块
    ├── __init__.py      # Scmp 客户端类
    ├── utils.py         # 工具函数
    └── responses.py     # 响应数据模型

安装方式

使用 pip

pip install py-tiehu-toolkit

使用 uv（推荐）

uv add py-tiehu-toolkit

从源码安装

git clone https://gitee.com/guolei19850528/py_tiehu_toolkit.git
cd py_tiehu_toolkit
uv install .

依赖包

快速开始

停车场模块 (Parking)

from py_tiehu_toolkit.parking import Pklot
from py_tiehu_toolkit.parking.responses import build_base_instance
from py_tiehu_toolkit.parking.utils import timestamp

# 创建同步客户端
pklot = Pklot(
    base_url="https://isc.example.com",
    parking_id="park001",
    app_key="your_app_secret"
)

# 发送请求
response = pklot.request_with_signature(url="/api/v1/query")

# 转换为响应模型
result = build_base_instance(response)
print(result.is_success())
print(result.Data)

SCMP 模块

from py_tiehu_toolkit.scmp import Scmp
from py_tiehu_toolkit.scmp.responses import build_base_instance

# 创建同步客户端
scmp = Scmp(
    base_url="https://scmp.example.com",
    appid="app001",
    secret="your_secret"
)

# 发送请求
response = scmp.request_with_token(url="/api/v1/data")

# 转换为响应模型
result = build_base_instance(response)
print(result.is_success())
print(result.data)

异步调用

import asyncio
from py_tiehu_toolkit.parking import Pklot

async def main():
    pklot = Pklot(
        base_url="https://isc.example.com",
        parking_id="park001",
        app_key="your_app_secret"
    )
    
    # 异步请求
    response = await pklot.async_request_with_signature(url="/api/v1/query")
    print(response.json())

asyncio.run(main())

API 参考

parking.Pklot 类

scmp.Scmp 类

utils 工具函数

模块差异说明

作者

Guolei - 174000902@qq.com

项目主页

• 仓库: https://gitee.com/guolei19850528/py_tiehu_toolkit
• 官方文档: https://www.showdoc.com.cn/1735808258920310/9467753400037587

许可证

MIT License