Всего три шага отделяют вас от интеграции генерации скриншотов в ваш продукт. Мы оптимизировали процесс для минимального времени на разработку.
Шаг 1
Регистрация и получение ключа
Зарегистрируйтесь в панели управления SnapStack. После подтверждения email перейдите в раздел Settings > API Keys. Нажмите Generate New Key, чтобы создать секретный токен.
Важно: Скопируйте ключ сразу. Для безопасности мы не сохраняем его в открытом виде в базе данных после первой генерации.
Шаг 2
Подготовка окружения
Добавьте ваш ключ в переменные окружения вашего проекта. Это предотвратит утечку данных в репозиторий кода.
SNAPSTACK_API_KEY="sk_live_8f9a2b3c4d5e6f7g8h9i0j"
Убедитесь, что ваш сервер имеет доступ к порту 443 для исходящих HTTPS-запросов.
Шаг 3
Первый API-запрос
Используйте метод POST для отправки URL страницы, которую нужно захватить. В примере ниже мы используем cURL для демонстрации.
curl -X POST https://api.snapstack.io/v1/capture \ -H "Authorization: Bearer $SNAPSTACK_API_KEY" \ -d '{"url": "https://example.com", "viewport": "1920x1080"}'
В ответ вы получите JSON-объект с ссылкой на сгенерированное изображение в формате PNG.
Если вы получили статус 200 OK, поздравляем! Ваша интеграция работает. Для детального описания параметров захвата (viewport, device emulation, wait time) обратитесь к разделу API Reference.