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 заявки тялото трябва да бъде stringified. Ако изпращате 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 Неоторизиран
    {
      "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 Неоторизиран
    {
      "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 Неоторизиран
    {
      "message": {}
    }

    Тялото на POST заявката трябва да бъде stringified (например 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 Неоторизиран
    {
      "message": {}
    }

    Тялото на PUT заявката трябва да бъде stringified.

    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 Неоторизиран
    {
      "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 Неоторизиран
    {
      "message": {}
    }

    Поддържани QR типове

    Използвайте тези типове метаданни при създаване или актуализиране на QR продукти.

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

    Започнете с динамични QR кодове и сменяеми QR кодове на нашата начална страница.