Как сделать свой первый скриншот с помощью SnapAPI

В этой статье мы рассмотрим, как создать скриншот веб-страницы с помощью нашего API. Сервис предоставляет простой и гибкий способ создания скриншотов с различными параметрами настройки.

Базовый пример

Самый простой способ получить скриншот - отправить GET запрос с URL страницы:

import requests

api_url = "https://api.snapapi.ru/api/v1/screenshot"
params = {
    "access_key": "ваш_ключ_доступа",
    "url": "https://example.com"
}

response = requests.get(api_url, params=params)

# Сохраняем скриншот
with open("screenshot.png", "wb") as f:
    f.write(response.content)

Настройка параметров

API поддерживает множество параметров для настройки скриншота:

params = {
    "access_key": "ваш_ключ_доступа",
    "url": "https://example.com",
    "width": 1920,          # Ширина viewport
    "height": 1080,         # Высота viewport
    "full_screen": "true",  # Скриншот всей страницы
    "timeout": 30,          # Таймаут ожидания загрузки в секундах
    "cache": 300,          # Время кэширования в секундах
    "force": "false"       # Принудительное обновление кэша
}

Обработка ошибок

API возвращает стандартные HTTP коды состояния:

• 200: Успешное выполнение

• 400: Неверные параметры запроса

• 401: Неверный ключ доступа

• 403: Превышен лимит запросов

• 500: Внутренняя ошибка сервера

response = requests.get(api_url, params=params)

if response.status_code != 200:
    print(f"Ошибка: {response.status_code}")
    print(response.text)
else:
    with open("screenshot.png", "wb") as f:
        f.write(response.content)