Controlled Test Website

riskapi test surface

This site tests one boundary: free API calls should work without Stripe, while Pro API calls should only work after a sandbox checkout has provisioned a key.

Open API reference
The website is static. The live backend is controlled separately, and some routes stay IP-restricted during testing.

Free checks

These are the baseline checks. If they work from an approved operator IP and fail from elsewhere, the access boundary is behaving as intended.

Ping

Basic no-charge liveness check.

GET Free
https://alpha-swan.duckdns.org/v1/free/ping

Current UTC Time

Return current UTC time and a Unix epoch value.

GET Free
https://alpha-swan.duckdns.org/v1/free/time/utc

Slugify Text

Convert a phrase into a clean lowercase ASCII slug.

POST Free
https://alpha-swan.duckdns.org/v1/free/text/slugify

Word Count

Return word, character, and line counts for a text block.

POST Free
https://alpha-swan.duckdns.org/v1/free/text/word-count

Extract URLs

Pull HTTP and HTTPS links out of plain text.

POST Free
https://alpha-swan.duckdns.org/v1/free/text/extract-urls

Unix To UTC

Convert a Unix epoch into an RFC 3339 UTC timestamp.

POST Free
https://alpha-swan.duckdns.org/v1/free/time/unix-to-utc

UTC To Unix

Convert an RFC 3339 timestamp into a Unix epoch value.

POST Free
https://alpha-swan.duckdns.org/v1/free/time/utc-to-unix

SHA-256 Hash

Return the SHA-256 hex digest for a string.

POST Free
https://alpha-swan.duckdns.org/v1/free/hash/sha256

Pro checks

These exist to validate the paid access boundary. They stay simple so checkout, key provisioning, and request gating remain the things under test.

Text Cleanup

Normalize whitespace and trim edges in a string.

POST
https://alpha-swan.duckdns.org/v1/tools/text/cleanup

Time Shift

Move a timestamp by a chosen number of minutes.

POST
https://alpha-swan.duckdns.org/v1/tools/time/shift

Quickstart

Start with the free routes. Use the Pro routes only when you want to verify the Stripe sandbox checkout and key-provisioning path.

curl https://alpha-swan.duckdns.org/v1/free/ping
curl https://alpha-swan.duckdns.org/v1/free/time/utc
curl -X POST https://alpha-swan.duckdns.org/v1/free/text/slugify \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, utility API world"}'
curl -X POST https://alpha-swan.duckdns.org/v1/free/hash/sha256 \
  -H "Content-Type: application/json" \
  -d '{"text":"abc"}'
curl -X POST https://alpha-swan.duckdns.org/v1/tools/text/cleanup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: rk_live_your_key_here" \
  -d '{"text":"   keep   this tidy   "}'

The full machine-readable contract is available in the OpenAPI reference linked above.

Test Pro pass flow

Use this only for Stripe sandbox testing. It creates a Checkout Session for the £1 Pro Test Pass and returns you here with a provisioned Pro key if payment succeeds.

This page uses Stripe sandbox only. The £1 value is for offer-shaping and flow testing; no real payment should occur here.