AuraAPI is a Cloudflare Workers API backed by D1, designed for postcode lookup in Poland. It returns full location context: address, address type, city, county and voivodeship.
Cloudflare Workers · D1 Database · RapidAPI Firewall Security
Built from the actual project architecture and current production behavior.
Route /api/postcode/{postcode} supports both XX-XXX and XXXXX formats.
Production table includes 42,712 cleaned records with corrected Polish characters.
Worker validates X-RapidAPI-Proxy-Secret and blocks direct unauthorized access.
Returns an array of all matching rows plus Count and global CodesInDB metrics.
Single Worker entry point routes traffic to dedicated microservice handlers in services/.
Prepared routes exist for future services: account verification and quote endpoint.
Where AuraAPI postcode lookup fits in real products.
👤 Registration Forms
Autocomplete city/region by postcode
📦 Shipping Logic
Validate destination coverage
🏢 CRM Enrichment
Normalize address records in leads
📈 Analytics
Aggregate users by voivodeship
Current behavior based on deployed production endpoint.
Request
GET /api/postcode/33-100 Header: X-RapidAPI-Proxy-Secret: <secret>
Response (fragment)
RapidAPI
{
"Result": [{
"Postcode": "33-100",
"Address": "Instytucja Rejonowy Urząd...",
"Location": "Tarnów"
}],
"Count": 2,
"CodesInDB": 42712
}
Access AuraAPI exclusively through RapidAPI and ship postcode intelligence in minutes.
Free API concept · Cloudflare native · Designed for Polish market data