Skip to content

HTTP/2

Test over the protocol you ship.

Ask libcurl for HTTP/2 on one request, on every request in a file, or for a whole run with --http2. Servers that don’t support it fall back to HTTP/1.1.

feed.yaml
# Or for a whole run: curl-runner feed.yaml --http2
global:
  http2: true

requests:
  - name: Feed over HTTP/2
    url: https://api.example.com/feed

  - name: Legacy endpoint
    url: https://legacy.example.com/feed
    http2: false

Benefits

  • Production parity

    Exercise the same protocol your clients use, including the server’s HTTP/2 configuration.

  • Granular control

    A file default, a per-request override, or a flag for one run — whichever fits.

  • Built on libcurl

    Negotiation and fallback come from libcurl’s mature HTTP/2 support, not a custom client.

Good for

  1. APIs served behind HTTP/2 load balancers
  2. Verifying a server’s HTTP/2 setup
  3. Comparing HTTP/1.1 and HTTP/2 behaviour
  4. Testing gRPC-adjacent HTTP/2 gateways