API Reference
Complete IOCode API surface — Admin (Python :3083) and Lookup (Go :3085).
IOCode System Overview
IOCode assigns deterministic, buyer-specific codes to hospitality products. Each property gets a unique internal sequence, and each buyer sees a different encrypted 8-character code (FFX/FF1 format-preserving encryption).
Services
| Service | Port | Tech | Purpose |
|---|---|---|---|
| Admin API | 3083 | Python/FastAPI | Registration, management, CRUD |
| Go Lookup | 3085 | Go/Chi | Sub-ms Redis lookups for buyers |
| Dashboard | 3087 | SvelteKit | Admin UI, API Explorer |
| Database | 5433 | PostgreSQL 16 | Identity, xref, audit schemas |
Code Format
| Type | Length | Example | Description |
|---|---|---|---|
| Property | 8 chars | K7NP4R2X | Buyer-specific property code |
| Room | 12 chars | K7NP4R2X-3F1 | Property code + room suffix |
Authentication
Admin endpoints are open (internal network). Buyer-facing endpoints require Authorization: Bearer <api_key>. Keys are SHA-256 hashed
and stored in auth.api_keys.