Our summary
The SDK is the official Python code library for connecting to TypeSafe. A normal connection goes directly to TypeSafe; a compatible gateway is another service that accepts the same request shape. Programs can select either route, a model, and how failed requests are retried.
A response model is a declared shape for the answers a program expects. The library checks and names those answers, reports request identifiers with errors, and supports clients that either wait for each result or handle other work while waiting. Connection and retry settings remain explicit.
Privacy needs special care: debug logs hide API keys and other secret headers, but request and response bodies are not redacted. The library also has an option that accepts new fields it does not yet recognize, though upgrading is preferred. Inspect logs and gateway handling before sending sensitive material.
Key takeaways
- A response model declares the shape of answers the program expects.
- A normal TypeSafe connection can be replaced by a compatible gateway—another service that follows the same request rules.
- Debug logging hides secret headers but does not hide private material inside request or response bodies.