GrandHubBusiness
    API документация
    v2.1.0
    OpenAPI 3.0

    GrandHub Business API

    Полная REST API документация для интеграции GrandHub Business в ваши системы. OpenAPI 3.0 спецификация, официальные SDK, webhook endpoints и примеры кода для автоматизации соблюдения AI-интеграция.

    REST API с JSON
    Официальные SDK
    Webhook интеграции
    Подписи сообщений
    API endpoints
    Основные категории API методов
    Управление задачами
    12 методов
    AI-аналитика
    8 методов
    Мониторинг бизнеса
    15 методов
    Аналитика и отчёты
    6 методов
    Управление пользователями
    10 методов
    Webhook управление
    4 метода

    Быстрый старт

    Начните интеграцию с GrandHub API за 5 минут

    1. Получите API ключ
    30 секунд
    Зарегистрируйтесь в GrandHub Business и создайте API ключ в разделе настроек интеграций.
    API_KEY=ghb_live_1234567890abcdef
    2. Установите SDK
    1 минута
    Используйте официальные SDK или напрямую работайте с REST API.
    npm install @grandhub/business-sdk
    3. Первый запрос
    2 минуты
    Выполните первый API вызов для создания задачи/сделки.
    client.tasks.create({...})

    Основные API методы

    Примеры самых используемых endpoint'ов

    POST
    /api/v2/task
    Создание нового задачи/сделки

    Пример запроса

    { "user_id": "usr_12345", "tasks": { "analytics": true, "marketing": false, "personalization": true, "cookies_necessary": true }, "task_method": "explicit", "ip_address": "192.168.1.1", "user_agent": "Mozilla/5.0...", "timestamp": "2025-09-21T16:00:00Z" }

    Ответ

    { "task_id": "task_67890", "status": "active", "created_at": "2025-09-21T16:00:00Z", "expires_at": "2026-09-21T16:00:00Z", "processing_status": "152FZ_compliant" }
    GET
    /api/v2/task/{user_id}
    Получение статуса задач пользователя

    Параметры

    user_idИдентификатор пользователя
    include_historyВключить историю изменений

    Ответ

    { "user_id": "usr_12345", "current_tasks": { "analytics": true, "marketing": false, "personalization": true }, "last_updated": "2025-09-21T16:00:00Z", "task_count": 3, "compliance_score": 100 }

    Официальные SDK

    Готовые библиотеки для популярных языков программирования

    JavaScript / TypeScript
    v2.1.0
    Официальный SDK для Node.js, React, Vue.js и других JavaScript фреймворков.
    npm install @grandhub/business-sdk
    Python
    v2.1.0
    SDK для Django, Flask, FastAPI и других Python веб-фреймворков.
    pip install grandhub-business
    Go
    v2.1.0
    Высокопроизводительный SDK для микросервисов и backend приложений на Go.
    go get github.com/grandhub/business-go
    C# / .NET
    v2.1.0
    SDK для ASP.NET Core, .NET Framework и других Microsoft технологий.
    dotnet add package Rescrub.Business
    Java
    v2.1.0
    SDK для Spring Boot, Spring Framework и других Java enterprise решений.
    <dependency>grandhub-business</dependency>
    Другие языки
    По запросу
    Нужна поддержка PHP, Ruby, Rust или другого языка? Свяжитесь с нами.

    Аутентификация

    Безопасная аутентификация через API ключи и JWT токены

    API ключи

    Простая и безопасная аутентификация через API ключи с возможностью ограничения доступа по IP адресам.

    JWT токены

    OAuth 2.0 совместимые JWT токены для интеграции с корпоративными системами аутентификации.

    Ограничения доступа

    Гибкая настройка ограничений: rate limiting, IP whitelist, webhook signatures для максимальной безопасности.

    Примеры аутентификации
    Способы передачи авторизационных данных

    HTTP заголовок

    Authorization: Bearer ghb_live_1234567890abcdef

    cURL пример

    curl -X GET \ -H "Authorization: Bearer ghb_live_1234567890abcdef" \ -H "Content-Type: application/json" \ https://api.grandhub.ru/v2/task/usr_12345

    Начните интеграцию с GrandHub API

    Полная документация, готовые SDK и техническая поддержка для разработчиков

    Бесплатный тестовый доступ
    Техподдержка разработчиков
    Подробная документация