Documentazione API

    Risorse per sviluppatori e guide per integrare QR Cake.

    JSON REST APICreazione dinamica di QR codeBearer Authorization

    Avvio rapido

    L'API di QR Cake consente agli utenti di QR Cake di gestire i QR code del proprio account.

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

    Autenticazione

    Crea una chiave API nella dashboard e inviala nell'header Authorization.

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

    Gestisci le chiavi API in Chiavi API nella dashboard.

    Tester richieste API

    Testa gli endpoint direttamente da questa pagina. Inserisci la tua chiave API, seleziona un endpoint e controlla la risposta in tempo reale.

    Tester API interattivo

    Esegui richieste direttamente dal browser verso l'endpoint dell'API di QR Cake selezionato.

    GET
    Authorization: Bearer <API Key>
    URL risolto
    https://api.qrcake.com/v1/product/user/product
    Esegui una richiesta per vedere qui stato e risposta in tempo reale.

    Terminologia

    Prodotti

    QR code

    Utenti

    Account QR Cake

    Body delle richieste (POST/PUT)

    Per le richieste POST e PUT, il body deve essere serializzato come stringa. Se invii JSON, passa una stringa JSON (ad esempio JSON.stringify(payload)).

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

    Elenca i QR code

    Elenca i QR code accessibili con la chiave API.

    Apri in GitBook
    Percorso: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Dettagli della richiesta
    Intestazioni
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Risposte
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Prodotti = QR code.

    GET

    Ottieni un codice QR

    Recupera un QR code.

    Apri in GitBook
    Percorso: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Dettagli della richiesta
    Parametri del percorso
    • productId (string)
    Intestazioni
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Risposte
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Crea un codice QR

    Crea un nuovo prodotto con codice QR.

    Apri in GitBook
    Percorso: /product
    URL: https://api.qrcake.com/v1/product/product
    Dettagli della richiesta
    Intestazioni
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Template del body
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Risposte
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Il body della richiesta POST deve essere serializzato come stringa (ad esempio JSON.stringify(payload)).

    PUT

    Aggiorna un codice QR

    Aggiorna un codice QR esistente (prodotto).

    Apri in GitBook
    Percorso: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Dettagli della richiesta
    Parametri del percorso
    • productId (string)
    Intestazioni
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Template del body
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Risposte
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Il body della richiesta PUT deve essere serializzato come stringa.

    DELETE

    Elimina un codice QR

    Elimina un codice QR.

    Apri in GitBook
    Percorso: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Dettagli della richiesta
    Parametri del percorso
    • productId (string)
    Intestazioni
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Risposte
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Autorizzazioni

    Restituisce le autorizzazioni concesse alla chiave API.

    Apri in GitBook
    Percorso: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Dettagli della richiesta
    Intestazioni
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Risposte
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Tipi di QR supportati

    Utilizza questi tipi di metadati durante la creazione o l'aggiornamento di prodotti QR.

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

    Inizia dalla nostra pagina iniziale con QR code dinamici e QR code modificabili.