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 savu kontu QR Codes.

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

    Autentifikācija

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

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

    Pārvaldīt API atslēgas Informācijas panelis API Taustiņi.

    API Pieprasīt pārbaudītāju

    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 <API Key>
    Atrisināts 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 Codes

    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

    Saraksts QR Codes

    Uzskaita QR Codes, kas pieejams ar taustiņu API.

    Atvērt GitBook
    Ceļš: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Pieprasīt detaļas
    Virsraksti
    • 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 Codes.

    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īt detaļas
    Ceļa parametri
    • productId (string)
    Virsraksti
    • 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īt detaļas
    Virsraksti
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Ķermeņa 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īt detaļas
    Ceļa parametri
    • productId (string)
    Virsraksti
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Ķermeņa 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īt detaļas
    Ceļa parametri
    • productId (string)
    Virsraksti
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Atbildes
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Atļaujas

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

    Atvērt GitBook
    Ceļš: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Pieprasīt detaļas
    Virsraksti
    • 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ākt ar dinamiskie QR kodi un maināmi QR kodi mūsu mājaslapā.