Documentació de l'API

    Recursos i guies per a desenvolupadors per integrar QR Cake.

    JSON REST APICreació dinàmica de QRAutorització Bearer

    Inici ràpid

    L'API de QR Cake permet als usuaris de QR Cake gestionar els seus codis QR.

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

    Autenticació

    Crea una clau d'API al teu tauler i envia-la a la capçalera Authorization.

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

    Gestiona les claus d'API Claus d'API del tauler.

    Provador de sol·licituds API

    Prova els punts finals directament des d'aquesta pàgina. Introdueix la teva clau d'API, selecciona un punt final i inspecciona la resposta en directe.

    Provador interactiu d'API

    Executa sol·licituds directament des del teu navegador al punt final d'API de QR Cake seleccionat.

    GET
    Authorization: Bearer YOUR_API_KEY
    URL resolta
    https://api.qrcake.com/v1/product/user/product
    Executa una sol·licitud per veure aquí l'estat en directe i la sortida de la resposta.

    Terminologia

    Productes

    Codis QR

    Usuaris

    Comptes de QR Cake

    Cossos de la sol·licitud (POST/PUT)

    Per a les sol·licituds POST i PUT, els cossos de la sol·licitud han de ser cadenes. Si envies JSON, passa una cadena JSON (per exemple JSON.stringify(payload)).

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

    Llista codis QR

    Llista els codis QR accessibles amb la clau d'API.

    Obre a GitBook
    Camí: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Detalls de la sol·licitud
    Capçaleres
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respostes
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Productes = codis QR.

    GET

    Obtén un codi QR

    Obtén un codi QR.

    Obre a GitBook
    Camí: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalls de la sol·licitud
    Paràmetres de ruta
    • productId (string)
    Capçaleres
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respostes
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Crea un codi QR

    Crea un producte de codi QR nou.

    Obre a GitBook
    Camí: /product
    URL: https://api.qrcake.com/v1/product/product
    Detalls de la sol·licitud
    Capçaleres
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Plantilla del cos
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Respostes
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    El cos de la sol·licitud POST ha de ser una cadena (per exemple, JSON.stringify(payload)).

    PUT

    Actualitza un codi QR

    Actualitza un codi QR existent (producte).

    Obre a GitBook
    Camí: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalls de la sol·licitud
    Paràmetres de ruta
    • productId (string)
    Capçaleres
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Plantilla del cos
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Respostes
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    El cos de la sol·licitud PUT ha de ser una cadena.

    DELETE

    Suprimeix un codi QR

    Esborra un codi QR.

    Obre a GitBook
    Camí: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalls de la sol·licitud
    Paràmetres de ruta
    • productId (string)
    Capçaleres
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respostes
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Permisos

    Retorna els permisos concedits a la clau d'API.

    Obre a GitBook
    Camí: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Detalls de la sol·licitud
    Capçaleres
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respostes
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Tipus de QR compatibles

    Fes servir aquests tipus de metadades quan creïs o actualitzis productes QR.

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

    Comença amb codis QR dinàmics i codis QR canviables a la nostra pàgina d'inici.