接口调不通很多时候不是参数值错了而是 HTTP 这一层没弄对——Content-Type 没对上、中文没编码、超时设得太短。这篇从 HTTP 层讲怎么构造请求、怎么看返回、怎么用 curl 把问题定位出来。一、请求构造方法、头、体三样接口基本都是 POST 加 JSON 体。头里要带两样Authorization 放 TokenContent-Type 固定 application/json。少一个都会出问题——Content-Type 不对服务端解析不了请求体写法见Eyun 开发文档。中文要留意编码。JSON 体一律用 UTF-8别手动转 GBK转了服务端读出来就是乱码这种问题在返回里看不出原因。二、返回结果先看 code 再看 data返回一般是固定结构code 表示业务结果msg 给错误描述data 放实际内容。解析时先判 code成功了才取 data失败直接按 msg 处理。错误码要分类不要一律重试。参数类错误缺字段、格式不对重试没有意义网络类错误超时、5xx才值得重试。混着处理会做很多无用功。三、用 curl 调试把请求复现出来调接口最快的办法是 curl。把同样的地址、头、体发一遍看返回。这样能把是不是代码的问题和是不是接口本身的问题分开。线上出问题时也一样把线上请求的参数原样复制到 curl本地复现比在代码里加一堆日志快得多。HTTP 层要点对照项要求常见问题排查方式方法与头POST application/json头没带全curl 复现编码UTF-8手动转 GBK 乱码看原始返回超时普通 10s大文件 15s默认值太短放大后重试错误码按类型处理一律重试分参数类/网络类请求封装与错误分类import requests class ApiCaller: RETRYABLE {408, 429, 500, 502, 503} # 网络类可重试 def __init__(self, base, token): self.base base self.token token def call(self, path, payload, timeout10, attempts3): last None for _ in range(attempts): try: r requests.post( f{self.base}{path}, jsonpayload, # 自动 UTF-8 编码 headers{ Authorization: self.token, Content-Type: application/json, }, timeouttimeout, ) except requests.Timeout as e: last e continue # 超时属可重试 if r.status_code in self.RETRYABLE: last r continue # 网络类可重试 body r.json() # 先解析结构 if body.get(code) ! 0: # 参数类错误直接返回不重试 return {code: body[code], msg: body.get(msg)} return body.get(data) raise RuntimeError(f重试 {attempts} 次仍失败: {last})落地建议请求头两样都要带Content-Type 必须与请求体一致。中文一律 UTF-8别手动转码。返回先判 code 再取 data失败按 msg 处理。错误码分参数类和网络类只有后者才重试。调试优先用 curl 复现比加日志高效。微信侧的接口调用由Eyun这类个人微信API平台 提供请求封装与重试策略在自建服务实现具体字段以Eyun 平台为准。