Documentation

404aaS provides a simple JSON API to generate fallback copy and UX for missing pages, error states, or other fallbacks. Make a single request and receive a polished message suitable for end users.

Authentication

All requests require an API key sent in the x-api-key header. Keep your key secret and rotate it if it becomes exposed. Create an account to get your personal API key.

Endpoint

GET /v1/message

https://api.404aas.com/v1/message?type=404&tone=playful&seed=42

Query parameters:

type: 404, 500, empty, maintenance, rate_limit
tone (optional): developer, playful, friendly, corporate, minimal
seed (optional): integer to generate consistent messages

The type parameter determines the kind of error message to return. The tone parameter controls the style of the message. If no tone is specified, a random one will be chosen. The seed parameter can be used to get the same message for the same type and tone, which is useful for testing and consistency across environments. We will continue to add more types and tones based on user feedback and demand.

For more information see the FastAPI documentation linked below.

See FastAPI Docs

Examples

The API can be called from any language that can make HTTP requests. Here are some examples in popular languages:

JavaScript

const response = await fetch("https://api.404aas.com/v1/message?type=404&tone=playful", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});

const data = await response.json();

Support

For API keys, billing, and integration help, email support@404aas.com.