Documentação da API
Recursos e guias para desenvolvedores integrarem o QR Cake.
Início rápido
A API do QR Cake permite que os usuários do QR Cake gerenciem os QR codes da conta.
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.
Authorization: Bearer <API Key>https://api.qrcake.com/v1/product/user/product
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),
});Lista QR Codes
Lista os QR codes acessíveis para a chave de API.
Authorization: Bearer <API Key>Accept: application/json
[
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
]{
"message": {}
}Produtos = QR codes.
Obter um QR code
Busca um QR code.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Criar um QR code
Cria um novo produto de QR code.
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}O corpo da solicitação POST deve ser stringificado (por exemplo, JSON.stringify(payload)).
Atualizar um QR code
Atualiza um QR code existente (produto).
- productId (string)
Authorization: Bearer <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"expiresAt": 0,
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}O corpo da solicitação PUT deve ser stringificado.
Excluir um QR code
Exclui um código QR.
- productId (string)
Authorization: Bearer <API Key>Accept: application/json
{
"productId": "string"
}{
"message": {}
}Permissões
Retorna as permissões concedidas à chave de API.
Authorization: Bearer <API Key>Accept: application/json
{
"success": true,
"result": {
"analytics": true,
"productLimit": 100,
"tier": "subscriber",
"productTotal": 3,
"productActiveLimit": 100,
"productActiveTotal": 3
}
}{
"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.