API

Gere QR Codes direto do seu sistema.

Uma chave de acesso, um endereço e cinco operações. Crie, liste, edite e exclua códigos sem abrir o gerador.

Comece por aqui

As três operações do dia a dia — gerar, listar e editar — em um exemplo único. Troque SUA_CHAVE pela chave criada na sua área de membros.

JavaScript

const CHAVE = 'SUA_CHAVE';
const BASE = 'https://auspicious-create-code-fast.base44.app/functions/qrApi';

const headers = { 'X-API-Key': CHAVE, 'Content-Type': 'application/json' };

// 1. Gerar um QR Code
const novo = await fetch(BASE, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    label: 'Cardápio',
    type: 'link',
    data: 'https://meurestaurante.com/menu',
    fgColor: '#0A0D0E',
    bgColor: '#FFFFFF',
  }),
}).then((r) => r.json());

console.log(novo.data.id);

// 2. Listar os códigos da conta
const lista = await fetch(BASE, { headers }).then((r) => r.json());

console.log(lista.data);

// 3. Editar um código existente
await fetch(BASE + '?id=' + novo.data.id, {
  method: 'PATCH',
  headers,
  body: JSON.stringify({ target: 'https://novo-destino.com' }),
});

Como autenticar

Endereço base

https://auspicious-create-code-fast.base44.app/functions/qrApi

Cabeçalho obrigatório

X-API-Key: SUA_CHAVE

Envie a chave em toda requisição. Use apenas no servidor: quem tiver a chave consegue criar e apagar códigos da sua conta.

Endpoints

GET

Listar códigos

Devolve todos os QR Codes salvos na conta, do mais recente para o mais antigo.

Requisição

curl "https://auspicious-create-code-fast.base44.app/functions/qrApi" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "data": [
    {
      "id": "68d1f0c4a91b2c0012ab34cd",
      "label": "Cardápio",
      "type": "link",
      "data": "https://meurestaurante.com/menu",
      "fgColor": "#0A0D0E",
      "bgColor": "#FFFFFF"
    }
  ]
}

POST

Criar código

Cria um QR Code na conta. Só o campo data é obrigatório.

Requisição

curl -X POST "https://auspicious-create-code-fast.base44.app/functions/qrApi" \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Cardápio",
    "type": "link",
    "data": "https://meurestaurante.com/menu",
    "fgColor": "#0A0D0E",
    "bgColor": "#FFFFFF",
    "frame": "scan",
    "frameText": "Veja o cardápio"
  }'

Resposta

{
  "data": {
    "id": "68d1f0c4a91b2c0012ab34cd",
    "label": "Cardápio",
    "type": "link",
    "data": "https://meurestaurante.com/menu",
    "created_date": "2026-09-23T00:12:41.000Z"
  }
}

GET

Buscar um código

Devolve os dados de um código específico pelo id.

Requisição

curl "https://auspicious-create-code-fast.base44.app/functions/qrApi?id=68d1f0c4a91b2c0012ab34cd" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "data": {
    "id": "68d1f0c4a91b2c0012ab34cd",
    "label": "Cardápio",
    "data": "https://meurestaurante.com/menu"
  }
}

PATCH

Atualizar código

Altera os campos enviados. Útil para trocar o destino de um código já impresso.

Requisição

curl -X PATCH "https://auspicious-create-code-fast.base44.app/functions/qrApi?id=68d1f0c4a91b2c0012ab34cd" \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "target": "https://meurestaurante.com/menu-de-outono" }'

Resposta

{
  "data": {
    "id": "68d1f0c4a91b2c0012ab34cd",
    "target": "https://meurestaurante.com/menu-de-outono"
  }
}

DELETE

Excluir código

Remove o código da conta. A ação não pode ser desfeita.

Requisição

curl -X DELETE "https://auspicious-create-code-fast.base44.app/functions/qrApi?id=68d1f0c4a91b2c0012ab34cd" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "deleted": "68d1f0c4a91b2c0012ab34cd"
}

Campos aceitos

labelNome do código, usado na sua lista.string

typelink, whatsapp, pix, wifi, vcard, phone, email ou location.string

dataConteúdo do código. Obrigatório.string

targetDestino para onde o código dinâmico aponta.string

isDynamicLiga o rastreamento de leituras no código.boolean

fgColor / bgColorCores do código, em hexadecimal.string

dotType / cornerType / cornerDotTypeFormato dos módulos e dos cantos.string

errorCorrectionLevelL, M, Q ou H.string

frame / frameText / frameColor / frameTextColorAdesivo e textos ao redor do código.string

image / backgroundImage / artImageURLs de logo, fundo ou arte (modo arte).string

sizeTamanho sugerido do arquivo final.number

Códigos de erro

401Chave ausente ou inválida

Confira o cabeçalho X-API-Key e se a chave ainda está ativa.

400Requisição inválida

Faltou o campo data no POST ou o parâmetro id na URL.

404Código não encontrado

O id não existe ou pertence a outra conta.

405Método não suportado

Use GET, POST, PATCH ou DELETE.

Códigos dinâmicos

Ao criar um código com isDynamic: true e um target, as leituras passam a ser registradas. Você troca o destino depois com um PATCH, sem precisar reimprimir o código.

Editar o destino

curl -X PATCH "https://auspicious-create-code-fast.base44.app/functions/qrApi?id=SEU_ID" \
  -H "X-API-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "target": "https://novo-destino.com" }'

Pronto para integrar?

Crie sua chave na área de membros e comece a gerar códigos.

Criar minha chave