Documentação da API

    Recursos e guias para desenvolvedores integrarem o QR Cake.

    REST JSON APICriação de QR dinâmicoBearer Authorization

    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

    Autenticação

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

    Authorization: Bearer <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 solicitações diretamente do seu navegador para o endpoint QR Cake API selecionado.

    GET
    Authorization: Bearer <API Key>
    URL resolvida
    https://api.qrcake.com/v1/product/user/product
    Execute uma requisição para ver aqui o status em tempo real e a resposta.

    Terminologia

    Produtos

    QR Codes

    Usuários

    contas do QR Cake

    Corpos da solicitação (POST/PUT)

    Em requisições POST e PUT, o corpo da requisição deve ser serializado. 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

    Lista QR Codes

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

    Abrir no GitBook
    Caminho: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Detalhes da solicitação
    Cabeçalhos
    • Authorization: Bearer <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/product/{productId}
    Detalhes da solicitação
    Parâmetros de caminho
    • productId (string)
    Cabeçalhos
    • Authorization: Bearer <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/product
    Detalhes da solicitação
    Cabeçalhos
    • Authorization: Bearer <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 solicitaçã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/product/{productId}
    Detalhes da solicitação
    Parâmetros de caminho
    • productId (string)
    Cabeçalhos
    • Authorization: Bearer <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 solicitação PUT deve ser stringificado.

    DELETE

    Excluir um QR code

    Exclui um código QR.

    Abrir no GitBook
    Caminho: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Detalhes da solicitação
    Parâmetros de caminho
    • productId (string)
    Cabeçalhos
    • Authorization: Bearer <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/permission
    Detalhes da solicitação
    Cabeçalhos
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Respostas
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "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

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