API перекеширования

Инвалидация кэша и ре-рендеринг страниц по требованию.

Эндпоинты

POST /recache

Инвалидировать кэш для URL и поставить в очередь ре-рендер.

Запрос:

bash
curl -X POST https://api.crawler-lens.ru/recache \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "project-id",
    "url": "https://example.com/page",
    "wait": false
  }'

Параметры:

Поле	Тип	Обязательно	Описание
projectId	string	✅	ID вашего проекта
url	string	✅	URL для перекеширования
wait	boolean	❌	Ждать рендер (макс 60с)

Ответ (wait=false):

json
{
  "success": true,
  "jobId": "job-123",
  "message": "Recache job queued",
  "url": "https://example.com/page"
}

Ответ (wait=true):

json
{
  "success": true,
  "jobId": "job-123",
  "message": "Page recached successfully",
  "url": "https://example.com/page",
  "snapshot": {
    "id": "snap-456",
    "renderTimeMs": 2340,
    "contentHash": "abc123",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

POST /recache/bulk

Перекешировать несколько URL сразу.

Запрос:

bash
curl -X POST https://api.crawler-lens.ru/recache/bulk \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "project-id",
    "urls": [
      "https://example.com/page1",
      "https://example.com/page2"
    ]
  }'

Лимиты:

Максимум 100 URL за запрос
Массовые задачи имеют низкий приоритет

GET /recache/status/:jobId

Проверить статус задачи перекеширования.

Ответ:

json
{
  "jobId": "job-123",
  "state": "completed",
  "progress": 100,
  "finishedOn": 1705319400000
}

Примеры использования

Обновление контента — Обновить кэш после публикации
Изменение цен — Обновить страницы товаров
Плановое обновление — Cron-задача для ключевых страниц