Python SDK 接入教程：10 分钟调通第一个接口

Python 用 requests 库发请求、hashlib 做 MD5 签名，几行即可接入。

pip install requests

YesApi 接口用签名（sign）防篡改，算法固定：把参数按 key 升序排序 → 拼接所有参数值（不含 key）→ 末尾追加 app_secret → MD5 → 转大写。各语言实现一致，务必与服务端保持相同规则。

import hashlib

# 签名：按 key 排序 → 拼接所有 value → 追加 app_secret → md5 → 大写
def yesapi_sign(params: dict, app_secret: str) -> str:
    s = ''.join(str(params[k]) for k in sorted(params))
    return hashlib.md5((s + app_secret).encode('utf-8')).hexdigest().upper()

请求方式为 POST，地址为 HOST/?s=服务名，参数用 form 表单编码，需带上 s、app_key 与计算好的 sign。下面是 Python 的完整可运行示例：

import requests

HOST = 'http://your-domain.yesapi.cn/'
APP_KEY = 'YOUR_APP_KEY'
APP_SECRET = 'YOUR_APP_SECRET'
SERVICE = 'App.Table.FreeQuery'

params = {'model_name': 'news', 'page': 1, 'perpage': 10}
params['s'] = SERVICE
params['app_key'] = APP_KEY
params['sign'] = yesapi_sign(params, APP_SECRET)

resp = requests.post(HOST.rstrip('/') + '/?s=' + SERVICE, data=params, timeout=5)
result = resp.json()
print(result)

YesApi 统一返回 JSON：ret 为状态码（200 成功），data 为业务数据，msg 为错误信息。务必判断 ret 再取数据：

# 统一返回：ret=200 成功
if result.get('ret') == 200:
    data = result['data']          # 业务数据
else:
    print('YesApi error:', result.get('msg', '请求失败'))

• 密钥安全：app_secret 只放服务端，切勿写进前端/App 客户端
• 超时与重试：设置合理超时（如 3-5s），对幂等接口做有限重试
• 时间戳/随机串：如服务端要求，可加 timestamp/nonce 参与签名防重放
• HTTPS：生产环境务必用 HTTPS，防止密钥与数据在传输中泄露