flask-restful的resource类需显式实现对应http动词的方法（如get、post），路径参数直接作为方法参数，查询参数须用reqparse或request.args获取；禁用可变类变量，错误响应应统一json格式而非abort()。
Resource类必须继承并实现HTTP方法对应的方法名
Flask-RESTful的Resource类本质是把HTTP动词映射成同名Python方法：你定义get()，它才响应GET；没写post()，POST请求直接405。不是靠装饰器或配置自动绑定。
- 常见错误：只写了
def get(self)，但想用PUT更新，结果返回Method Not Allowed - 所有支持的动词都得显式写出方法体，哪怕只是
return {"msg": "not implemented"} - 方法签名不能加额外必填参数——
def get(self, user_id)可以（由URL参数传入），但def get(self, token)不行，除非token来自reqparse或request.args
URL参数和查询参数要分清来源和校验方式
路径里的变量（如/users/<user_id></user_id>）在get(self, user_id)里直接当函数参数；而?page=2&sort=name这种得从request.args或reqparse.RequestParser取——混用会导致参数丢失或类型错误。
- 用
reqparse更安全：它能强制类型转换、设默认值、报错提示，比如parser.add_argument("page", type=int, default=1, location="args") - 别在
get(self, user_id)里再手动调request.args.get("user_id")——路径参数已由Flask路由解析好，重复取可能覆盖或类型错乱 -
location="json"适用于POST/PUT请求体，但前提是客户端发的是Content-Type: application/json，否则reqparse收不到数据
Resource类实例不共享状态，但类变量会跨请求污染
Resource每次请求都会新建实例，所以self.xxx是安全的；但如果你不小心在类定义里写了cache = {}，这个字典会在所有请求间共享，导致数据串扰或内存泄漏。
- 典型踩坑：在
class UserResource(Resource): cache = {}里缓存用户数据，结果A用户删了记录，B用户还读到旧缓存 - 正确做法：用
functools.lru_cache装饰函数，或依赖外部缓存（Redis）、或每次在get()里新建临时结构 - 数据库连接、配置对象这些“只读”类变量可以放类上，但带状态的容器（list/dict/set）一律禁止声明为类属性
错误处理别只靠abort()，要统一响应格式
abort(404)会中断流程并返回纯文本，和你用return {"error": "not found"}不一致。前端要统一解析JSON，就得让所有错误也走return + 状态码。
- 推荐方式：自定义异常类 +
api.error_handlers，比如api.handle_error(UserNotFound)返回{"error": "user not found"}和404 - 别在每个
get()里写if not user: return {"error": "..."}, 404——重复逻辑多，漏写状态码是高频bug -
abort()适合调试时快速中断，上线前应替换为结构化返回，尤其涉及400/401/422等业务错误时
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
