02 Sequence
SDK Flag Check: the Conditional Read
One flag check, start to finish โ including the cold path where the cache misses and the snapshot is rebuilt.
The client reads conditionally and decides locally, so an unchanged environment costs one small round trip and never a full snapshot transfer. On a miss the API rebuilds the snapshot from PostgreSQL and writes it through. The response names its own source in the X-Catalyst-Cache header, which is the only external signal of which layer answered.
What to look for
- Compare the warm path with the cold path shown here: a 304 skips the snapshot load entirely.
- The version read happens before the cache read, because that row is what validates the cache entry.
- Identity is a hard gate, not a formality โ an unknown key never reaches the snapshot service.