Dokumentácia API pre dynamické QR kódy | QR Cake

    Vytvárajte, aktualizujte a spravujte dynamické QR kódy cez API QR Cake. Používajte kľúče API, testujte požiadavky a zapojte QR kódy do vlastných pracovných postupov.

    JSON REST APIDynamická tvorba QROverenie pomocou kľúča API

    Rýchly štart

    API QR Cake umožňuje používateľom QR Cake spravovať svoje QR kódy v účte.

    Základná URL
    https://api.qrcake.com/v1/product/api

    Autentifikácia

    Vytvorte si kľúč API vo svojom hlavnom paneli a odošlite ho v hlavičke x-api-key.

    x-api-key: <API Key>
    Content-Type: application/json

    Spravujte kľúče API v Kľúče API v hlavnom paneli.

    Tester API požiadaviek

    Testujte koncové body priamo z tejto stránky. Zadajte svoj kľúč API, vyberte koncový bod a skontrolujte aktuálnu odpoveď.

    Interaktívny tester API

    Spúšťajte požiadavky priamo z prehliadača do vybratého koncového bodu QR Cake API.

    GET
    x-api-key: YOUR_API_KEY
    Výsledná URL
    https://api.qrcake.com/v1/product/api/product
    Spustite požiadavku, aby ste tu videli aktuálny stav a výstup odpovede.

    Terminológia

    Produkty

    QR kódy

    Používatelia

    Účty QR Cake

    Telá požiadaviek (POST/PUT)

    V prípade požiadaviek POST a PUT musia byť telá požiadaviek odovzdané ako reťazec (stringified). Ak odosielate JSON, odovzdajte reťazec JSON (napríklad JSON.stringify(payload)).

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

    Zoznam QR kódov

    Uvádza zoznam QR kódov prístupných pre kľúč API.

    Otvoriť v GitBook
    Cesta: /product
    URL: https://api.qrcake.com/v1/product/api/product
    Podrobnosti požiadavky
    Hlavičky
    • x-api-key: <API Key>
    • Accept: application/json
    Odpovede
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Produkty = QR kódy.

    GET

    Získať QR kód

    Načíta jeden QR kód.

    Otvoriť v GitBook
    Cesta: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Podrobnosti požiadavky
    Parametre cesty
    • productId (string)
    Hlavičky
    • x-api-key: <API Key>
    • Accept: application/json
    Odpovede
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Vytvoriť QR kód

    Vytvorí nový QR kód (produkt).

    Otvoriť v GitBook
    Cesta: /product
    URL: https://api.qrcake.com/v1/product/api/product
    Podrobnosti požiadavky
    Hlavičky
    • x-api-key: <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Šablóna tela
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Odpovede
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Telo požiadavky POST musí byť odovzdané ako reťazec (napríklad JSON.stringify(payload)).

    PUT

    Aktualizovať QR kód

    Aktualizuje existujúci QR kód (produkt).

    Otvoriť v GitBook
    Cesta: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Podrobnosti požiadavky
    Parametre cesty
    • productId (string)
    Hlavičky
    • x-api-key: <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Šablóna tela
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Odpovede
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Telo požiadavky PUT musí byť odovzdané ako reťazec.

    DELETE

    Odstrániť QR kód

    Odstráni QR kód.

    Otvoriť v GitBook
    Cesta: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Podrobnosti požiadavky
    Parametre cesty
    • productId (string)
    Hlavičky
    • x-api-key: <API Key>
    • Accept: application/json
    Odpovede
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Povolenia

    Vráti povolenia udelené kľúču API.

    Otvoriť v GitBook
    Cesta: /permission
    URL: https://api.qrcake.com/v1/product/api/permission
    Podrobnosti požiadavky
    Hlavičky
    • x-api-key: <API Key>
    • Accept: application/json
    Odpovede
    200 OK
    {
      "success": true,
      "result": {
        "tier": "subscriber",
        "active": true,
        "analytics": true,
        "productLimit": 100,
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Podporované typy QR

    Tieto typy metadát použite pri vytváraní alebo aktualizácii produktov QR.

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

    Začnite s dynamickými QR kódmi a meniteľnými QR kódmi na našej domovskej stránke.