API and SDK

How it works

Authorized integrations use versioned Yasnora APIs and SDKs. Pass identity and policy context and request logical capabilities rather than hard-coding a physical provider.

What to do

1. Use the API contract and SDK version approved for your deployment.
2. Propagate tenant, workspace, subject, role, locale and request ID.
3. Set bounded timeouts and cancellation; use idempotency for writes.
4. Handle Retry-After and safe retries with jitter; refresh an expired session and retry only once.

What to check

For streaming, distinguish partial data from the final result and handle finish, cancel, errors and usage. Do not treat a dropped stream as successful completion or retry a write blindly.