Documentație API

    Resurse și ghiduri pentru dezvoltatori privind integrarea QR Cake .

    JSON REST APICreare QR dinamicăBearer Autorizare

    Pornire rapidă

    QR Cake API permite utilizatorilor QR Cake să își gestioneze contul QR Codes.

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

    Autentificare

    Creează o cheie API în panoul de control și trimite-o în antetul Authorization.

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

    Gestionează cheile API în Cheile API din panou.

    Tester pentru cereri API

    Testează endpoint-urile direct de pe această pagină. Introdu cheia API, alege un endpoint și inspectează răspunsul live.

    Tester interactiv API

    Rulează cereri direct din browser către endpoint-ul QR Cake API selectat.

    GET
    Authorization: Bearer YOUR_API_KEY
    URL rezolvat
    https://api.qrcake.com/v1/product/user/product
    Rulează o cerere pentru a vedea aici statusul live și răspunsul.

    Terminologie

    Produse

    Coduri QR

    Utilizatori

    QR Cake conturi

    Corpul cererilor (POST/PUT)

    Pentru cererile POST și PUT, corpul cererii trebuie să fie un șir. Dacă trimiteți JSON, transmiteți un șir JSON (de exemplu JSON.stringify(payload)).

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

    Listează codurile QR

    Listează codurile QR accesibile cu cheia API.

    Deschide în GitBook
    Cale: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Detalii cerere
    Anteturi
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Răspunsuri
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Products = Coduri QR.

    GET

    Obține un cod QR

    Preia un cod QR.

    Deschide în GitBook
    Cale: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalii cerere
    Parametri în cale
    • productId (string)
    Anteturi
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Răspunsuri
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Creează un cod QR

    Creează un nou produs Cod QR.

    Deschide în GitBook
    Cale: /product
    URL: https://api.qrcake.com/v1/product/product
    Detalii cerere
    Anteturi
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Șablon corp
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Răspunsuri
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Corpul cererii POST trebuie să fie stringificat (de exemplu, JSON.stringify(payload)).

    PUT

    Actualizează un cod QR

    Actualizează un cod QR existent (produs).

    Deschide în GitBook
    Cale: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalii cerere
    Parametri în cale
    • productId (string)
    Anteturi
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Șablon corp
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Răspunsuri
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Corpul cererii PUT trebuie să fie stringificat.

    DELETE

    Șterge un cod QR

    Șterge un cod QR.

    Deschide în GitBook
    Cale: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalii cerere
    Parametri în cale
    • productId (string)
    Anteturi
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Răspunsuri
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Permisiuni

    Returnează permisiunile acordate cheii API.

    Deschide în GitBook
    Cale: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Detalii cerere
    Anteturi
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Răspunsuri
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Tipuri QR acceptate

    Folosește aceste tipuri de metadate atunci când creezi sau actualizezi produsele QR.

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

    Începe cu codurile QR dinamice și codurile QR modificabile pe pagina noastră principală.