Статьи
Сам по себе cache ничего не хранит. Он просит API найти готовый снимок с тем же адресом, форматом и параметрами. Попадание возвращает 200 и этот скриншот, включая image_url, и не ставит в очередь другое задание.
На POST /api/v1/screenshots cache по умолчанию равен false. Задайте true, чтобы взять уже снятое. Попадание всё равно считается в месячный лимит и в лимит в минуту. На GET /api/v1/screenshots/embed cache по умолчанию равен true, и повторное попадание уже не считается. Задайте cache равным false в URL встраивания, если нужен новый файл. fresh у элемента пакета — короткая форма: true снимает заново, а false включает кэш.
cache_ttl — окно в секундах. По умолчанию 14 400, то есть четыре часа, и значение может быть от 60 секунд до 2 592 000 секунд, то есть 30 дней. Совпадают адрес, формат и сохранённые параметры. cache_key — дополнительный параметр до 200 символов, поэтому новый ключ даёт промах кэша, даже если страница и формат не менялись. external_identifier тоже пишется в параметры, до 128 символов, и так же меняет совпадение.
Попадание не прокручивает страницу заново и не вызывает ваш вебхук ради новой отрисовки. Вы получаете прежний скриншот. Если подписанный URL в этой записи истёк, запросите скриншот снова, и придёт новая ссылка. Срок жизни ссылки по умолчанию — пять минут. Смените cache_key или отправьте fresh true, если страница изменилась и старое изображение было бы неверным.
cache |
Берёт готовый снимок с тем же адресом, форматом и параметрами. По умолчанию false на POST и true в URL встраивания. |
|---|---|
cache_ttl |
Окно в секундах. По умолчанию 14 400. От 60 до 2 592 000. |
cache_key |
Дополнительный ключ совпадения, до 200 символов. Другой ключ не возьмёт предыдущий снимок. |
fresh |
Псевдоним для пакета. true принудительно делает новую съёмку. false задаёт cache равным true, если cache ещё не передан. |
Нет. Попадание в кэш на POST всё равно считается. Попадание в кэш на URL встраивания не считается. Промах считается в обоих случаях.
Отличались формат или какой-либо параметр. cache_key, external_identifier, устройство и флаг баннера входят в сохранённые параметры.
Задайте cache равным true и cache_ttl равным 86400. Следующий совпадающий запрос в течение этих суток вернёт готовый снимок.
Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.