Developer Docs

Build on the Finkkle stack.

A practical path from your first request to a production integration with search, Spaces, and the wider Octanami platform.

Quickstart

Create a project, generate a scoped API key, and send a health check before wiring product behavior. Keep keys server-side and rotate them when a teammate or environment changes.

curl https://api.finkkle.com/v1/health \
  -H "Authorization: Bearer $FINKKLE_API_KEY"

Integration pattern

1. Authenticate at your backend.
2. Validate inputs and normalize query intent.
3. Call the search or Spaces endpoint with an explicit timeout.
4. Stream or render the response, then log request IDs for support.

Webhooks and retries

Handle events idempotently. Store the event ID before applying side effects, acknowledge quickly, and retry transient failures with exponential backoff.