API объектного шлюза
S3-совместимый доступ только на чтение. Базовый адрес:
https://yandex.mirror.cdn.n08i40k.ru
Получить объект
GET /api/v2/assets/{bucket}/{key}
Возвращает содержимое объекта. Поддерживаются диапазонные запросы через заголовок
Range и условные запросы через If-None-Match.
Заголовки ответа
| Заголовок | Описание |
|---|---|
ETag | Хеш содержимого объекта. |
Cache-Control | Политика кеширования на краю сети. |
X-Cache | HIT или MISS — источник ответа. |
x-amz-request-id | Идентификатор запроса для трассировки. |
Accept-Ranges | Поддержка диапазонных запросов. |
Пример
curl -sS \ -H "Range: bytes=0-1023" \ https://yandex.mirror.cdn.n08i40k.ru/api/v2/assets/media/hero.webp \ -o hero.part
Коды ошибок
| Код | Значение |
|---|---|
| 200 / 206 | Объект отдан полностью или частично. |
| 304 | Объект не изменился (совпал ETag). |
| 404 | Объект не найден (NoSuchKey). |
| 416 | Некорректный диапазон Range. |