If-None-Match header, and the API returns 304 Not Modified if the resource has not changed, saving bandwidth and reducing your monthly usage count.
How ETag caching works
1
Make a request
The response includes an
ETag header with a unique identifier for the current state of the resource.Response headers
2
Send the ETag on subsequent requests
Include the
If-None-Match header with the ETag value:3
Receive a 304 if unchanged
If the resource hasn’t changed, the API returns
304 Not Modified with no body:Why use ETag caching
- Save bandwidth by not re-downloading unchanged data
- Reduce monthly usage since
304 Not Modifiedresponses do not count against your monthly quota - Faster responses with no response body to parse
When ETag caching is not available
ETags are not supported in these cases:- Requests that include the
q(search) parameter - Requests that include the
updated_afterparameter - List endpoints (only individual resource endpoints support ETags)