Duration Wait API

A simple API endpoint that waits for a specified duration and returns a success message.

Usage

Make a GET request to the endpoint with a seconds query parameter:

GET /?seconds=5

Parameters

seconds (required): Duration to wait in seconds. Must be a non-negative number.

Response

Success (200):

{
  "success": true,
  "message": "Wait completed successfully",
  "requestedSeconds": 5,
  "actualDurationMs": 5001,
  "cappedAt": null
}

Error (400):

{
  "error": "Seconds parameter is required. Provide duration in seconds as a query parameter."
}

Features

Validates seconds parameter (must be non-negative number)
Caps duration at 60 seconds (Val Town free tier timeout limit)
Pro accounts support up to 10 minutes
Returns actual wait time for verification
Indicates if duration was capped

Val Town Timeout Limits

Free accounts: Maximum 60 seconds
Pro accounts: Maximum 10 minutes (600 seconds)

This endpoint automatically caps the duration based on the free tier limit. For longer durations, upgrade to Pro.

Examples

# Wait for 2 seconds
curl "https://your-val-url/?seconds=2"

# Wait for 10 seconds
curl "https://your-val-url/?seconds=10"

# Error: missing seconds
curl "https://your-val-url/"

# Error: invalid seconds
curl "https://your-val-url/?seconds=invalid"

romj