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

    Π‘ΠΎΠ·Π΄Π°Π²Π°ΠΉΡ‚Π΅, обновляйтС ΠΈ управляйтС динамичСскими QR-ΠΊΠΎΠ΄Π°ΠΌΠΈ Ρ‡Π΅Ρ€Π΅Π· QR Cake API. Π˜ΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠΉΡ‚Π΅ API-ΠΊΠ»ΡŽΡ‡ΠΈ, тСстируйтС запросы ΠΈ ΠΏΠΎΠ΄ΠΊΠ»ΡŽΡ‡Π°ΠΉΡ‚Π΅ QR-процСссы ΠΊ своим инструмСнтам.

    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 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": {}
    }

    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-ΠΊΠΎΠ΄ΠΎΠ² Π½Π° нашСй Π³Π»Π°Π²Π½ΠΎΠΉ страницС.