Infrastructure
Authentication, pagination, and real-time capabilities.
API Key Auth
Secure authentication with scoped API keys and rate limiting.
Entrada
Key name and scopes
Rate limit and daily quota
Expiration date and IP allowlist
Saída
API key in naper_xxx format
Hash stored securely
Usage analytics and rate limit headers
Casos de Uso
Create key per application
Read-only keys for partners
Rotate key without downtime
Monitor usage per key
Key per team member
Cursor Pagination
Efficient cursor-based pagination for large datasets alongside standard offset pagination.
Entrada
Limit and offset parameters
Cursor for real-time pagination
Configurable page size
Saída
Paginated data with metadata
x-total-count header
Next/previous cursors
Casos de Uso
Navigate large catalogs
Real-time feeds
Integrations with simple offset
Paginate search results
Incremental data sync
Server Events
Real-time SSE streams for monitoring async operations and job progress.
Entrada
SSE connection via GET /server-events
Filters by event type
Saída
Real-time event stream
Enrichment job progress
Import/export operation status
Automatic reconnection on drop
Casos de Uso
Monitor enrichment progress
Real-time operations dashboard
Job completion notifications
Track import/export
Integrate status in external system