Documentação da API de QR codes dinâmicos | QR Cake

    Crie, atualize e gerencie QR codes dinâmicos com a API do QR Cake. Use chaves de API, teste requisições e conecte fluxos de QR às suas próprias ferramentas.

    API REST JSONCriação de QR dinâmicoAutenticação por chave de API

    Início rápido

    A API do QR Cake permite que os usuários do QR Cake gerenciem os QR codes da conta.

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

    Autenticação

    Crie uma chave de API no seu painel e envie-a no cabeçalho x-api-key.

    x-api-key: <API Key>
    Content-Type: application/json

    Gerencie as chaves de API em Chaves de API no painel.

    Testador de requisições da API

    Teste endpoints diretamente nesta página. Informe sua chave de API, selecione um endpoint e inspecione a resposta em tempo real.

    Testador interativo da API

    Execute requisições diretamente do seu navegador para o endpoint selecionado da API do QR Cake.

    GET
    x-api-key: YOUR_API_KEY
    URL resolvida
    https://api.qrcake.com/v1/product/api/product
    Execute uma requisição para ver aqui o status em tempo real e a resposta.

    Terminologia

    Produtos

    Códigos QR

    Usuários

    contas do QR Cake

    Corpos da requisição (POST/PUT)

    Em requisições POST e PUT, o corpo da requisição deve ser stringificado. Se você estiver enviando JSON, passe uma string JSON (por exemplo JSON.stringify(payload)).

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

    Listar QR codes

    Lista os QR codes acessíveis para a chave de API.

    Abrir no GitBook
    Caminho: /product
    URL: https://api.qrcake.com/v1/product/api/product
    Detalhes da requisição
    Cabeçalhos
    • x-api-key: <API Key>
    • Accept: application/json
    Respostas
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Produtos = QR codes.

    GET

    Obter um QR code

    Busca um QR code.

    Abrir no GitBook
    Caminho: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Detalhes da requisição
    Parâmetros de caminho
    • productId (string)
    Cabeçalhos
    • x-api-key: <API Key>
    • Accept: application/json
    Respostas
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Criar um QR code

    Cria um novo produto de QR code.

    Abrir no GitBook
    Caminho: /product
    URL: https://api.qrcake.com/v1/product/api/product
    Detalhes da requisição
    Cabeçalhos
    • x-api-key: <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Modelo de corpo
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Respostas
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    O corpo da requisição POST deve ser stringificado (por exemplo, JSON.stringify(payload)).

    PUT

    Atualizar um QR code

    Atualiza um QR code existente (produto).

    Abrir no GitBook
    Caminho: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Detalhes da requisição
    Parâmetros de caminho
    • productId (string)
    Cabeçalhos
    • x-api-key: <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Modelo de corpo
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Respostas
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    O corpo da requisição PUT deve ser stringificado.

    DELETE

    Excluir um QR code

    Exclui um QR code.

    Abrir no GitBook
    Caminho: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Detalhes da requisição
    Parâmetros de caminho
    • productId (string)
    Cabeçalhos
    • x-api-key: <API Key>
    • Accept: application/json
    Respostas
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Permissões

    Retorna as permissões concedidas à chave de API.

    Abrir no GitBook
    Caminho: /permission
    URL: https://api.qrcake.com/v1/product/api/permission
    Detalhes da requisição
    Cabeçalhos
    • x-api-key: <API Key>
    • Accept: application/json
    Respostas
    200 OK
    {
      "success": true,
      "result": {
        "tier": "subscriber",
        "active": true,
        "analytics": true,
        "productLimit": 100,
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Tipos de QR suportados

    Use estes tipos de metadados ao criar ou atualizar produtos QR.

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

    Comece com QR codes dinâmicos e QR codes editáveis na nossa página inicial.