Function _parse_positive_int

backend/api.py:195–207

将查询参数解析为正整数，非法时返回校验错误响应（None 表示解析成功）。

(raw, name: str, default: int, maximum: int = 200)

def _parse_positive_int(raw, name: str, default: int, maximum: int = 200):
    """将查询参数解析为正整数，非法时返回校验错误响应（None 表示解析成功）。"""
    if raw is None:
        return default, None
    try:
        value = int(raw)
    except (ValueError, TypeError):
        return None, ({"field": name, "message": "须为整数"}, 400)
    if value < 1:
        return None, ({"field": name, "message": "须为正整数（≥1）"}, 400)
    if value > maximum:
        return None, ({"field": name, "message": f"不得超过 {maximum}"}, 400)
    return value, None


@app.route('/api/v1/requests', methods=['GET'])