diff --git a/data/api/server-server/content_repository.yaml b/data/api/server-server/content_repository.yaml index 02b367df..6c19d6ec 100644 --- a/data/api/server-server/content_repository.yaml +++ b/data/api/server-server/content_repository.yaml @@ -52,6 +52,11 @@ paths: can be retrieved. The URL at `Location` SHOULD have appropriate `Content-Type` and `Content-Disposition` headers which describe the media. + + When `Location` is present, servers SHOULD NOT cache the URL. + The remote server may have applied time limits on its validity. + If the caller requires an up-to-date URL, it SHOULD re-request + the media download. "429": $ref: '#/components/responses/rateLimited' "502": @@ -165,6 +170,11 @@ paths: `Content-Type` and `Content-Disposition` headers which describe the media. + When `Location` is present, servers SHOULD NOT cache the URL. + The remote server may have applied time limits on its validity. + If the caller requires an up-to-date URL, it SHOULD re-request + the media download. + {{% boxes/note %}} The `Content-Type` for the second part SHOULD be one of: * `image/png` (possibly of the APNG variety)