Документация API

    Ресурсы и руководства для разработчиков по интеграции QR Cake.

    JSON REST APIДинамическое создание QR-кодовАвторизация Bearer

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

    API QR Cake позволяет пользователям QR Cake управлять своими QR-кодами в аккаунте.

    Базовый URL
    https://api.qrcake.com/v1/product

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

    Создайте API-ключ в панели управления и передавайте его в заголовке Authorization.

    Authorization: Bearer <API Key>
    Content-Type: application/json

    Управляйте ключами API в API-ключах панели управления.

    Тестер API-запросов

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

    Интерактивный тестер API

    Отправляйте запросы из браузера прямо к выбранному API-эндпоинту QR Cake.

    GET
    Authorization: Bearer <API Key>
    Итоговый URL
    https://api.qrcake.com/v1/product/user/product
    Выполните запрос, чтобы увидеть здесь текущий статус и ответ.

    Терминология

    Продукты

    QR-коды

    Пользователи

    аккаунты QR Cake

    Тела запроса (POST/PUT)

    Для запросов POST и PUT тело запроса должно быть сериализовано в строку. Если вы отправляете JSON, передавайте JSON-строку (например, JSON.stringify(payload)).

    const payload = { redirect: "https://example.com", metadata: {} };
    
    await fetch(url, {
      method: "POST",
      body: JSON.stringify(payload),
    });
    GET

    Список QR-кодов

    Возвращает список QR-кодов, доступных по этому API-ключу.

    Открыть в GitBook
    Путь: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Детали запроса
    Заголовки
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Ответы
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Products = QR-коды.

    GET

    Получить QR-код

    Получает один QR-код.

    Открыть в GitBook
    Путь: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Детали запроса
    Параметры пути
    • productId (string)
    Заголовки
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Ответы
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Создать QR-код

    Создает новый продукт с QR-кодом.

    Открыть в GitBook
    Путь: /product
    URL: https://api.qrcake.com/v1/product/product
    Детали запроса
    Заголовки
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Шаблон тела
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Ответы
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Тело POST-запроса должно быть сериализовано в строку (например, JSON.stringify(payload)).

    PUT

    Обновить QR-код

    Обновляет существующий QR-код (продукт).

    Открыть в GitBook
    Путь: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Детали запроса
    Параметры пути
    • productId (string)
    Заголовки
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Шаблон тела
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Ответы
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Тело PUT-запроса должно быть сериализовано в строку.

    DELETE

    Удалить QR-код

    Удаляет QR-код.

    Открыть в GitBook
    Путь: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Детали запроса
    Параметры пути
    • productId (string)
    Заголовки
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Ответы
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Разрешения

    Возвращает разрешения, предоставленные ключу API.

    Открыть в GitBook
    Путь: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Детали запроса
    Заголовки
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Ответы
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Поддерживаемые типы QR-кодов

    Используйте эти типы метаданных при создании или обновлении QR-продуктов.

    redirect, link, image, video, file, pdf, audio, app, event, vCard

    Начните с динамических QR-кодов и изменяемых QR-кодов на нашей главной странице.