API-dokumentasjon

    Utviklerressurser og veiledninger for å integrere QR Cake.

    JSON REST APIDynamisk oppretting av QR-koderBearer Authorization

    Rask start

    QR Cake API lar QR Cake-brukere administrere QR-kodene i kontoen sin.

    Basis-URL
    https://api.qrcake.com/v1/product

    Autentisering

    Opprett en API-nøkkel i dashbordet ditt og send den i Authorization-headeren.

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

    Administrer API-nøkler i API-nøkler i dashbordet.

    API-forespørselstester

    Test endepunkter direkte fra denne siden. Skriv inn API-nøkkelen din, velg et endepunkt og inspiser live-responsen.

    Interaktiv API-tester

    Kjør forespørsler direkte fra nettleseren til det valgte QR Cake API-endepunktet.

    GET
    Authorization: Bearer <API Key>
    Løst URL
    https://api.qrcake.com/v1/product/user/product
    Kjør en forespørsel for å se status og svar her.

    Terminologi

    Produkter

    QR-koder

    Brukere

    QR Cake-kontoer

    Innhold i forespørselen (POST/PUT)

    For POST- og PUT-forespørsler må request body serialiseres som streng. Hvis du sender JSON, må du sende en JSON-streng (for eksempel JSON.stringify(payload)).

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

    Hent liste over QR-koder

    Lister opp QR-kodene API-nøkkelen har tilgang til.

    Åpne i GitBook
    Sti: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Forespørselsdetaljer
    Overskrifter
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Svar
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Produkter = QR-koder.

    GET

    Hent en QR-kode

    Henter én QR-kode.

    Åpne i GitBook
    Sti: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Forespørselsdetaljer
    Baneparametere
    • productId (string)
    Overskrifter
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Svar
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Opprett en QR-kode

    Oppretter et nytt QR-kodeprodukt.

    Åpne i GitBook
    Sti: /product
    URL: https://api.qrcake.com/v1/product/product
    Forespørselsdetaljer
    Overskrifter
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Forespørselsmal
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Svar
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    POST-forespørselens body må serialiseres som streng (for eksempel JSON.stringify(payload)).

    PUT

    Oppdater en QR-kode

    Oppdaterer en eksisterende QR-kode (produkt).

    Åpne i GitBook
    Sti: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Forespørselsdetaljer
    Baneparametere
    • productId (string)
    Overskrifter
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Forespørselsmal
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Svar
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    PUT-forespørselens body må serialiseres som streng.

    DELETE

    Slett en QR-kode

    Sletter en QR-kode.

    Åpne i GitBook
    Sti: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Forespørselsdetaljer
    Baneparametere
    • productId (string)
    Overskrifter
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Svar
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Tillatelser

    Returnerer tillatelsene som er gitt til API-nøkkelen.

    Åpne i GitBook
    Sti: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Forespørselsdetaljer
    Overskrifter
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Svar
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Støttede QR-typer

    Bruk disse metadatatypene når du oppretter eller oppdaterer QR-produkter.

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

    Start med dynamiske QR-koder og redigerbare QR-koder på forsiden vår.