API dokumentáció

    Fejlesztői források és útmutatók a QR Cake integrálásához.

    JSON REST APIDinamikus QR-készítésBearer hitelesítés

    Gyors kezdés

    A QR Cake API lehetővé teszi a QR Cake felhasználók számára, hogy programozottan kezeljék a QR-kódjaikat.

    Alap URL
    https://api.qrcake.com/v1/product

    Hitelesítés

    Hozzon létre egy API kulcsot az irányítópulton, és küldje el az Authorization fejlécben.

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

    API kulcs kezelése Irányítópult API kulcsok.

    API kérés-tesztelő

    Tesztelje a végpontokat közvetlenül erről az oldalról. Írja be az API kulcsát, válasszon egy végpontot, és ellenőrizze az élő választ.

    Interaktív API-tesztelő

    Futtasson kéréseket közvetlenül a böngészőből a kiválasztott QR Cake API végpontra.

    GET
    Authorization: Bearer YOUR_API_KEY
    Feloldott URL
    https://api.qrcake.com/v1/product/user/product
    Futtasson egy kérést az élő állapot és a válasz kimenetének megtekintéséhez.

    Terminológia

    Termékek

    QR-kódok

    Felhasználók

    QR Cake fiók

    Kérés-törzsek (POST/PUT)

    A POST és a PUT kérések esetében a kérés törzsét sztringként kell átadni. Ha JSON-t küld, adjon át egy JSON-sztringet (például JSON.stringify(payload)).

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

    QR-kódok listázása

    Felsorolja az API kulcs számára elérhető QR-kódokat.

    Megnyitás a GitBookban
    Útvonal: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Kérés részletei
    Fejlécek
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Válaszok
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    A termékek = QR-kódok.

    GET

    QR-kód lekérése

    Lekér egy QR-kódot.

    Megnyitás a GitBookban
    Útvonal: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Kérés részletei
    Útvonal paraméterei
    • productId (string)
    Fejlécek
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Válaszok
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    QR-kód létrehozása

    Új QR-kód terméket hoz létre.

    Megnyitás a GitBookban
    Útvonal: /product
    URL: https://api.qrcake.com/v1/product/product
    Kérés részletei
    Fejlécek
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Törzs-sablon
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Válaszok
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    A POST kérés törzsét sztringként kell átadni (például JSON.stringify(payload)).

    PUT

    QR-kód frissítése

    Meglévő QR-kód (termék) frissítése.

    Megnyitás a GitBookban
    Útvonal: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Kérés részletei
    Útvonal paraméterei
    • productId (string)
    Fejlécek
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Törzs-sablon
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Válaszok
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    A PUT kérés törzsét sztringként kell átadni.

    DELETE

    QR-kód törlése

    Törli a QR-kódot.

    Megnyitás a GitBookban
    Útvonal: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Kérés részletei
    Útvonal paraméterei
    • productId (string)
    Fejlécek
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Válaszok
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Engedélyek

    Az API kulcsnak adott engedélyeket adja vissza.

    Megnyitás a GitBookban
    Útvonal: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Kérés részletei
    Fejlécek
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Válaszok
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Támogatott QR-típusok

    Használja ezeket a metaadattípusokat QR-termékek létrehozásakor vagy frissítésekor.

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

    Kezdje ezzel: dinamikus QR-kódok és cserélhető QR-kódok a honlapunkon.