Скриншоты

Кэш и render links

Кэш уменьшает повторные рендеры, а render link даёт стабильный непрозрачный URL для результата, который можно обновлять.

Кэш запроса

Установите cache=true. Совместимый завершённый результат в пределах tenant возвращается как HIT и не расходует ещё одну единицу квоты. forceRefresh=true создаёт свежий результат.

json

{
  "url": "https://example.com/status",
  "cache": true,
  "cacheTtlSeconds": 3600,
  "cacheKey": "public-status-v1"
}

Render link

POST /v1/render-links создаёт ссылку вида /r/{token}. Токен непрозрачный и должен храниться как секретная ссылка. Render links принимают URL-конфигурацию, но не raw HTML или Markdown.

json

{
  "screenshot": {
    "url": "https://example.com/badge",
    "format": "png"
  },
  "ttlSeconds": 3600
}

Обновляйте результат через POST /v1/render-links/{id}/refresh, а не создавайте новый link. Удаляйте link через DELETE /v1/render-links/{id}, когда публичный доступ больше не нужен.