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

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

    JSON REST APIДинамічне створення QRBearer-авторизація

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

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

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

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

    Створіть ключ API на панелі керування та надішліть його у заголовку авторизації.

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

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

    Тестування API

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

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

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

    GET
    Authorization: Bearer YOUR_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": {}
    }

    Продукти = 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-кодів на нашій головній сторінці.