Changelog
v0.2.0 - API keys & avatars
Adds authenticated access via magic-link API keys and a new avatar generation endpoint.
API key onboarding
- Request an API key at
/get-key: a magic link is sent to your email and activates your key instantly - Dashboard at
/dashboardshows your key, current usage, and daily limit - Usage is tracked per key; each request decrements your daily quota
- Authenticated requests use the
X-API-Keyheader; keys unlock higher rate-limit tiers (Builder: 1,000 req/day, Scale: unlimited)
Avatar endpoint
- New
GET /v1/avatarendpoint that returns a deterministic African-style avatar as SVG or PNG - Seed any string to get a stable, reproducible avatar across requests
- Supports body styles (female, male, neutral) and hair styles (afro, cornrows, dreadlocks, fade, gele, natural, twa)
- Format controlled via
?format=svg(default) or?format=png
v0.1.0 - Initial release
First public release of MockAfrica.
- Five countries at launch: GH, NG, KE, ZA, RW
- Five endpoint groups: person, company, location, finance, dataset
- IP-based rate limiting (100 req/day anonymous)
- Sub-millisecond responses, no external lookups or cold starts