Skip to content

docs: replace dead jsontest.com example URLs - #1243

Merged
tommysitu merged 7 commits into
SpectoLabs:masterfrom
spramanigit:patch-1
Sep 3, 2026
Merged

docs: replace dead jsontest.com example URLs#1243
tommysitu merged 7 commits into
SpectoLabs:masterfrom
spramanigit:patch-1

Conversation

@spramanigit

Copy link
Copy Markdown
Contributor

jsontest.com (used as the example host in the delays and specific-URLs tutorials) is no longer live - it now returns a Cloudflare 530 (origin unreachable) error, so these tutorials no longer work as written for anyone following along.

This replaces the dead URLs with two live public test APIs: api.ipify.org in place of ip.jsontest.com / time.jsontest.com (kept the "contains ip" property the specific-URLs tutorial's destination filter relies on), and httpbin.org in place of date.jsontest.com / the second delay-example host.

Touches both tutorials end to end: the .rst prose, the shell script examples, and the shared multiple-hosts-delay-simulation.json fixture used by the delays tutorial. Happy to adjust to a different replacement host if you'd prefer - just wanted to get the dead link fixed since it breaks the copy-paste examples as they stand.

jsontest.com is no longer live (returns a Cloudflare 530 origin-unreachable error), so the tutorials that use time.jsontest.com and date.jsontest.com as example hosts no longer work as written. This replaces them with api.ipify.org and httpbin.org, two live public test APIs, across the delays and specific-URLs tutorials (rst files, shell script examples, and the shared simulation JSON fixture).

@tommysitu tommysitu left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cool, I will revert https back to http because that will break the tutorial.

@tommysitu
tommysitu merged commit 7f7c8ce into SpectoLabs:master Sep 3, 2026
3 checks passed
tommysitu added a commit that referenced this pull request Sep 3, 2026
PR #1243 replaced the dead jsontest.com hosts with api.ipify.org and
httpbin.org, but also switched the examples from http:// to https://.

Hoverfly MITMs every HTTPS CONNECT, so a reader following these tutorials
gets a TLS verification failure (curl exit 60, "self signed certificate in
certificate chain") unless they have already installed Hoverfly's CA. The
HTTPS tutorial covers this and passes --cacert cert.pem, but it sits later
in the toctree than delays/ and specificurls/, and neither of these scripts
downloads or passes the certificate. In filter-dest.sh both requests fail,
including httpbin.org, because the destination filter gates capture rather
than interception.

Both replacement hosts serve plain HTTP, so revert the scheme and keep the
tutorials copy-pasteable with no certificate step. The regex dry-run example
lower in specificurls.rst keeps its https:// URLs -- that block never sends
traffic.

Verified by running the scripts as written, with no --cacert:
  filter-dest-dry-run.sh  matches api.ipify.org, not httpbin.org
  filter-dest.sh          captures only api.ipify.org
  delays-simulate.sh      1.002s on api.ipify.org, 2.002s on httpbin.org

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants