Документація API для динамічних QR-кодів | QR Cake

    Створюйте й оновлюйте динамічні QR-коди та керуйте ними через QR Cake API. Використовуйте ключі API, тестуйте запити та підключайте робочі процеси QR до власних інструментів.

    JSON REST APIДинамічне створення QRАвтентифікація за ключем API

    Швидкий старт

    QR Cake API дозволяє користувачам QR Cake керувати QR-кодами свого облікового запису.

    Базова URL-адреса
    https://api.qrcake.com/v1/product/api

    Автентифікація

    Створіть ключ API у своїй панелі керування та надішліть його в заголовку x-api-key.

    x-api-key: <API Key>
    Content-Type: application/json

    Керуйте ключами API в Ключі API на панелі керування.

    Тестування API

    Тестуйте кінцеві точки безпосередньо з цієї сторінки. Введіть свій ключ API, виберіть кінцеву точку та перевірте відповідь у реальному часі.

    Інтерактивне тестування API

    Виконуйте запити безпосередньо з вашого браузера до вибраної кінцевої точки QR Cake API.

    GET
    x-api-key: YOUR_API_KEY
    Кінцевий URL
    https://api.qrcake.com/v1/product/api/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
    Шлях: /product
    URL: https://api.qrcake.com/v1/product/api/product
    Деталі запиту
    Заголовки
    • x-api-key: <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": {}
    }

    Продукти = QR-коди.

    GET

    Отримати QR-код

    Повертає один QR-код.

    Відкрити в GitBook
    Шлях: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Деталі запиту
    Параметри шляху
    • productId (string)
    Заголовки
    • x-api-key: <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/api/product
    Деталі запиту
    Заголовки
    • x-api-key: <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/api/product/{productId}
    Деталі запиту
    Параметри шляху
    • productId (string)
    Заголовки
    • x-api-key: <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/api/product/{productId}
    Деталі запиту
    Параметри шляху
    • productId (string)
    Заголовки
    • x-api-key: <API Key>
    • Accept: application/json
    Відповіді
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Дозволи

    Повертає дозволи, надані ключу API.

    Відкрити в GitBook
    Шлях: /permission
    URL: https://api.qrcake.com/v1/product/api/permission
    Деталі запиту
    Заголовки
    • x-api-key: <API Key>
    • Accept: application/json
    Відповіді
    200 OK
    {
      "success": true,
      "result": {
        "tier": "subscriber",
        "active": true,
        "analytics": true,
        "productLimit": 100,
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Підтримувані типи QR

    Використовуйте ці типи метаданих під час створення або оновлення QR-продуктів.

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

    Почніть з динамічних QR-кодів або змінних QR-кодів на нашій головній сторінці.