API dokumentācija

    Izstrādātāju resursi un rokasgrāmatas QR Cake integrēšanai.

    JSON REST APIDinamiskā QR izveideBearer Autorizācija

    Ātrais sākums

    QR Cake API ļauj QR Cake lietotājiem pārvaldīt sava konta QR kodus.

    Bāzes URL
    https://api.qrcake.com/v1/product

    Autentifikācija

    Informācijas panelī izveidojiet API atslēgu un nosūtiet to autorizācijas galvenē.

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

    Pārvaldīt API atslēgas Informācijas paneļa API atslēgas.

    API pieprasījumu testētājs

    Pārbaudiet galapunktus tieši no šīs lapas. Ievadiet savu API atslēgu, atlasiet galapunktu un pārbaudiet tiešo atbildi.

    Interaktīvs API testeris

    Izpildiet pieprasījumus tieši no pārlūkprogrammas uz atlasīto QR Cake API galapunktu.

    GET
    Authorization: Bearer YOUR_API_KEY
    Atrisinātais URL
    https://api.qrcake.com/v1/product/user/product
    Izpildiet pieprasījumu, lai šeit skatītu tiešraides statusu un atbildes izvadi.

    Terminoloģija

    Produkti

    QR kodi

    Lietotāji

    QR Cake konti

    Pieprasījuma struktūras (POST/PUT)

    Pieprasījumiem POST un PUT pieprasījuma pamattekstiem jābūt stringificētiem. Ja sūtāt JSON, nosūtiet JSON virkni (piemēram, JSON.stringify(payload)).

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

    QR kodu saraksts

    Uzskaita API atslēgai pieejamos QR kodus.

    Atvērt GitBook
    Ceļš: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Pieprasījuma detaļas
    Galvenes
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Atbildes
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Produkti = QR kodi.

    GET

    Iegūstiet QR kodu

    Ienes vienu QR kodu.

    Atvērt GitBook
    Ceļš: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Pieprasījuma detaļas
    Ceļa parametri
    • productId (string)
    Galvenes
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Atbildes
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Izveidojiet QR kodu

    Izveido jaunu QR koda produktu.

    Atvērt GitBook
    Ceļš: /product
    URL: https://api.qrcake.com/v1/product/product
    Pieprasījuma detaļas
    Galvenes
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Pamatteksta veidne
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Atbildes
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    POST pieprasījuma pamattekstam ir jābūt stringificētam (piemēram, JSON.stringify(payload)).

    PUT

    Atjauniniet QR kodu

    Atjaunina esošu QR kodu (produktu).

    Atvērt GitBook
    Ceļš: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Pieprasījuma detaļas
    Ceļa parametri
    • productId (string)
    Galvenes
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Pamatteksta veidne
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Atbildes
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    PUT pieprasījuma pamattekstam ir jābūt stringificētam.

    DELETE

    Izdzēsiet QR kodu

    Izdzēš QR kodu.

    Atvērt GitBook
    Ceļš: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Pieprasījuma detaļas
    Ceļa parametri
    • productId (string)
    Galvenes
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Atbildes
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Atļaujas

    Atgriež API atslēgai piešķirtās atļaujas.

    Atvērt GitBook
    Ceļš: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Pieprasījuma detaļas
    Galvenes
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Atbildes
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Atbalstītie QR veidi

    Izmantojiet šos metadatu veidus, veidojot vai atjauninot QR produktus.

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

    Sāciet ar dinamiskajiem QR kodiem un maināmajiem QR kodiem mūsu mājaslapā.