TSHTTPTXNS...RINTERCEPT(3ts)

✨ NAME ✨

TSHttpTxnServerIntercept — bestie, you get to intercept origin server requests 💅

---

🌸 SYNOPSIS 🌸

#include <ts/ts.h>

void TSHttpTxnServerIntercept(TSCont contp, TSHttpTxn txnp)

---

💖 DESCRIPTION 💖

okay so TSHttpTxnServerIntercept() is lowkey iconic — it lets a plugin straight up take over the servicing of the request, like it is the origin server. main character energy fr fr. 🎀

here's the vibe: if a request needs to be made to the server for transaction txnp, then contp gets sent a TS_EVENT_NET_ACCEPT event. the edata that comes with TS_EVENT_NET_ACCEPT is a TSVConn, exactly like it would be for a normal accept. and then your plugin has to act like it's an HTTP server — meaning you read the HTTP request and body from the TSVConn, and you send back an HTTP response header and body. that's the whole job. no pressure bestie 🫶

⚠️ TSHttpTxnServerIntercept() must not be called after the connection to the server has already taken place. so the last hook you can call it from is TS_HTTP_READ_CACHE_HDR_HOOK. and if a connection to the server isn't necessary at all, the continuation contp gets a TS_EVENT_NET_ACCEPT_FAILED event instead when the transaction completes. 💀

the response from the plugin gets cached, subject to the standard and configured HTTP caching rules — so if your plugin does not want the response cached, you gotta use the appropriate HTTP response headers to prevent caching. that's on you, not on ATS. 🙈

the primary purpose of TSHttpTxnServerIntercept() is to let plugins provide gateways to other protocols, or to let one plugin use its own transport for the next hop to the server. and yes, TSHttpTxnServerIntercept() overrides parent cache configuration. it said "i'm the parent now". 👑

💀 also, TSHttpTxnServerIntercept() must only be called once per transaction. and the continuation contp must have been created with a valid TSMutex. no exceptions, no cap.

---

🦋 SEE ALSO 🦋

• TSAPI(3ts)

---

👑 COPYRIGHT 👑

2026, dev@trafficserver.apache.org

---

k that's the whole page, you're welcome 💖 this was Apache Traffic Server, version 9.2, dated Feb 12, 2026, page TSHTTPTXNS...RINTERCEPT(3ts) — go forth and intercept, bestie, you got this 🌈✨🍓