网关主入口(步骤 2~7 都在这里),把请求转发到上游并把结果回给用户。

参数 path:被通配符捕获的端点路径,如 "UserTweets" 或 "UserTweets/xxx"。 参数 user:由 get_api_key_user 完成鉴权(未带/无效 key 时它已抛 401)。

返回:成功时是上游原始 body + 若干 X-TwtAPI-* 元信息头; 上游 4xx/5xx 被改写成 502(业务码在 body 里);上游超时/不可达返回 200 + 20401。 副作用:写 Redis(限流、信用点、缓存、配额快照)、写库(风控事件;调用日志走后台任务)、 发起上游 HTTP 请求。

计费语义:进入这里的请求在预检阶段就已经扣过费,所以每个失败出口都必须退款。 先扣后转的代价是失败路径要显式补偿,好处是并发下不会出现「先转发后扣费、 余额不足时白送一次上游调用」的超发。

patch/api/v1/twitter/{path}

Request

  • Base URL: https://api.twtapi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.twtapi.com/api/v1/twitter/{path}
  • Auth: none declared

Path parameters

pathstring required

Response

Successful Response

unknown required

Changes

    • info

      api operation id proxy_api_v1_twitter__path__get removed and replaced with proxy_api_v1_twitter__path__delete