Skip to content

Avatorsinc/aaas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏗️ Architect as a Service (AaaS)

A tiny, free HTTP API that returns what the Architect would actually say — bilingual (🇵🇱 / 🇬🇧).

GET /
→ { "persona": "Architect", "lang": "pl", "message": "mam spotkanie", "status": "meeting", "timestamp": "..." }

Every request returns a random line. Built as a single Cloudflare Worker — no server to maintain, generous free tier.

Live demo: https://aaas.lxvii.workers.dev


Using the API

Base URL: https://aaas.lxvii.workers.dev (or your own — see Deploy).

Everything is a plain GET, CORS is enabled, responses are JSON.

Endpoints

URL Returns
/ random line, Polish (default)
/en random line, English
/?lang=en random line, English (query form)
/?status=ticket random line of a given status
/en/?status=excuse status filter + language
/all · /en/all the full list in that language

Parameters

  • langpl (default) · en
  • statusbusy · meeting · ticket · scope · excuse

Examples

# curl
curl -s https://aaas.lxvii.workers.dev | jq -r .message
curl -s "https://aaas.lxvii.workers.dev/en/?status=excuse" | jq -r .message
# PowerShell
(Invoke-RestMethod "https://aaas.lxvii.workers.dev").message
(Invoke-RestMethod "https://aaas.lxvii.workers.dev/en").message
# Python
import requests
print(requests.get("https://aaas.lxvii.workers.dev/en").json()["message"])
// JavaScript (browser / Node)
const r = await fetch("https://aaas.lxvii.workers.dev/en");
console.log((await r.json()).message);

Deploy your own

You need a free Cloudflare account (no card required) and Node.js.

git clone https://github.com/<you>/aaas.git
cd aaas
npm install
npx wrangler login      # one-time browser auth
npm run deploy

Wrangler prints your live URL, e.g. https://aaas.<your-subdomain>.workers.dev.

Run it locally first with npm run dev.


Customize the lines

All content lives in one file: responses.json. Add an entry and redeploy:

{ "pl": "twoja nowa kwestia", "en": "your new line", "status": "busy" }
  • pl / en — the message in each language (both required)
  • status — group it under a category; use any string you like (busy, meeting, ticket, scope, excuse, …)
npm run deploy   # publish your changes

How it works

File Role
responses.json the data — single source of truth, bilingual
worker.js the API — routing, language/status filtering, random pick
wrangler.toml Cloudflare Worker config
index.html optional standalone demo page

License

MIT — do whatever you want with it.

About

Architect as a Service (AaaS) — a free bilingual Polish/English API for realistic architect status messages and excuses.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages