Статьи

Повторно использовать недавний скриншот

Сам по себе cache ничего не хранит. Он просит API найти готовый снимок с тем же адресом, форматом и параметрами. Попадание возвращает 200 и этот скриншот, включая image_url, и не ставит в очередь другое задание.

Статьи по API скриншотов

POST и встраивание считаются по-разному

На 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 скриншот из месячного лимита?

Нет. Попадание в кэш на POST всё равно считается. Попадание в кэш на URL встраивания не считается. Промах считается в обоих случаях.

Почему два одинаковых адреса не попали в кэш?

Отличались формат или какой-либо параметр. cache_key, external_identifier, устройство и флаг баннера входят в сохранённые параметры.

Можно ли хранить снимок главной сутки?

Задайте cache равным true и cache_ttl равным 86400. Следующий совпадающий запрос в течение этих суток вернёт готовый снимок.

Другие статьи

Альтернативы, которые используют эти поля

Сравнения

Отправьте первый адрес

Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.