QRStuff (versão prévia)
QRStuff é uma plataforma de código QR profissional. Gere códigos QR dinâmicos e estáticos, gerencie projetos, acompanhe a análise de verificação em tempo real por data, país, região e dispositivo, carregue ativos de identidade visual e gerencie sua conta.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Suporte a QRStuff |
| URL | https://www.qrstuff.com/contact |
| support@qrstuff.com |
| Metadados do conector | |
|---|---|
| Publicador | QRStuff |
| Website | https://www.qrstuff.com |
| Política de privacidade | https://www.qrstuff.com/privacy-policy |
| Categories | Produtividade; Marketing |
QRStuff
Publisher: QRStuff
O QRStuff é uma plataforma profissional de gerenciamento de código QR que permite que os usuários gerem códigos QR dinâmicos e estáticos, organizem-nos em projetos, acompanhem a análise de verificação em tempo real e gerenciem as configurações da conta. Com esse conector, você pode automatizar fluxos de trabalho de código QR diretamente em seus fluxos e aplicativos de negócios.
Prerequisites
Para usar esse conector, você precisa:
- Uma conta QRStuff (inscreva-se gratuitamente em qrstuff.com)
- Uma assinatura paga do QRStuff para acessar recursos dinâmicos de gerenciamento de código QR e análise
Operações com suporte
| Operation | Category | Description |
|---|---|---|
| Obter perfil de usuário | Conta | Recuperar nome, email, nome comercial, telefone e fuso horário |
| Obter detalhes da assinatura | Conta | Recuperar informações atuais de plano, status e cobrança |
| Listar projetos | Projetos | Listar todos os projetos de código QR com paginação |
| Criar Projeto | Projetos | Criar um novo projeto para organizar códigos QR |
| Listar projetos excluídos | Projetos | Listar projetos com exclusão reversível que podem ser restaurados |
| Restaurar Project Excluídos | Projetos | Restaurar um projeto excluído anteriormente |
| Listar códigos QR | Códigos QR | Listar códigos QR na conta com pesquisa e paginação |
| Gerar código QR | Códigos QR | Criar um novo código QR com tipo, conteúdo e estilo |
| Obter detalhes do código QR | Códigos QR | Detalhes completos, incluindo contagem de verificação, URL de visualização, URL de download |
| Atualizar código QR | Códigos QR | Atualizar URL de destino, nome ou tipo de conteúdo |
| Listar códigos QR no Project | Códigos QR | Todos os códigos QR dentro de um projeto específico |
| Restaurar código QR excluído | Códigos QR | Restaurar um código QR excluído anteriormente |
| Mover o código QR para Project | Códigos QR | Mover um código QR de um projeto para outro |
| Transferir código QR | Códigos QR | Transferir um código QR anônimo para uma conta registrada |
| Obter histórico de código QR | Códigos QR | Alterar e auditar o histórico de um código QR específico |
| Carregar Arquivo | Arquivos | Carregar uma imagem para uso como logotipo de código QR ou plano de fundo |
| Obter visão geral da conta | Analytics | Total de projetos, códigos QR, verificações e usuários exclusivos |
| Obter atividade de conta | Analytics | Uso dinâmico de QR, limites de verificação mensal, verificações este mês |
| Obter total de verificações | Analytics | Contagem total de verificação para código de conta, projeto ou QR |
| Obter usuários exclusivos | Analytics | Contagem de scanner exclusiva para conta, projeto ou código QR |
| Obter a data de melhor desempenho | Analytics | Dia com o maior número de verificações em um determinado período |
| Obter o local de melhor desempenho | Analytics | País com mais verificações em um determinado período |
| Obter o código QR do scanner superior | Analytics | Código QR com a maioria das verificações para conta ou projeto |
| Obter verificações de conta | Analytics | Dados de verificação paginados agrupados por verificação, data, país, região ou dispositivo |
| Obter verificações de Project | Analytics | Logs de verificação paginados para um projeto específico |
| Obter verificações de código QR | Analytics | Logs de verificação paginados para um código QR específico |
| Obter verificações por data | Analytics | Contagens de verificação agrupadas por data |
| Obter verificações por país | Analytics | Contagens de verificação agrupadas por país |
| Obter verificações por região | Analytics | Contagens de verificação agrupadas por região dentro de um país |
| Obter verificações por dispositivo | Analytics | Contagens de verificação agrupadas por plataforma de dispositivo |
| Criar tíquete de suporte | Support | Enviar uma solicitação de suporte para a equipe do QRStuff |
| Obter a URL de Revisão do Trustpilot | Support | Obter o link personalizado de revisão do Trustpilot |
| Base de dados de conhecimento de pesquisa | Support | Pesquisar artigos e perguntas frequentes sobre a ajuda do QRStuff |
Obtendo credenciais
Para usuários finais
- Entre em sua conta do QRStuff em app.qrstuff.com.
- Ao adicionar esse conector em Power Apps ou Power Automate, clique em Entrar.
- Você será redirecionado para a página de logon do QRStuff OAuth.
- Insira seu email e senha do QRStuff e clique em Autorizar.
- Você será redirecionado novamente e a conexão será estabelecida automaticamente.
Nenhuma chave de API ou configuração de token manual é necessária – o conector usa o OAuth 2.0 com atualização automática de token.
Para Microsoft Equipe de Certificação (Registro de Aplicativo OAuth)
Esse conector usa o DCR (Registro dinâmico de cliente) RFC 7591 para registrar clientes OAuth. Para obter uma ID de cliente válida e um segredo do cliente para implantação, envie uma solicitação POST para o ponto de extremidade de registro QRStuff:
-
Ponto de extremidade:
https://api.qrstuff.com/api/oauth/register -
Método:
POST -
Cabeçalhos:
Content-Type: application/jsonAccept: application/json
-
Corpo da solicitação:
{ "client_name": "QRStuff Power Platform Connector", "redirect_uris": ["https://global.consent.azure-apim.net/redirect"] }
A resposta retornará e client_idclient_secret será configurada nos ambientes de produção Microsoft Power Platform.
Problemas e limitações conhecidos
- A geração de novos códigos QR (POST para criar) tem suporte por meio da plataforma Web QRStuff ou servidor MCP. Esse conector se concentra na leitura, atualização e gerenciamento de projetos e códigos QR existentes.
- O gerenciamento dinâmico de código QR requer uma assinatura paga ativa.
- Os pontos de extremidade de análise (verificações por data, país, dispositivo) estão disponíveis por meio do conector do servidor MCP QRStuff para fluxos de trabalho assistidos por IA.
Perguntas frequentes
P: Um plano pago é necessário?
R: Uma conta gratuita permite ler dados de perfil e de projeto. O gerenciamento dinâmico de código QR e a análise exigem um plano pago.
P: Onde posso obter suporte?
R: Entre em contato com o suporte do QRStuff em qrstuff.com/contact ou email support@qrstuff.com.
P: Quais regiões têm suporte?
R: A API QRStuff está disponível globalmente por meio de api.qrstuff.com.
Ações
| Atualizar código QR |
Atualize a URL de destino, o nome ou o tipo de conteúdo de um código QR existente. |
| Carregar Arquivo |
Carregue uma imagem ou arquivo de ativo (PNG, JPEG, SVG) para usar como um logotipo ou plano de fundo no estilo de código QR. |
| Criar Projeto |
Crie um novo projeto para organizar códigos QR. |
| Gerar código QR |
Gere um novo código QR com o tipo, o conteúdo e as opções de estilo opcionais especificados. |
| Listar códigos QR |
Recupere uma lista paginada de códigos QR na conta. Opcionalmente, filtre por consulta de pesquisa. |
| Listar códigos QR no Project |
Recupere todos os códigos QR pertencentes a um projeto específico. |
| Listar projetos |
Recupere uma lista paginada de projetos de código QR. Use deleted=1 para listar projetos excluídos. |
| Mover o código QR para Project |
Mova um ou mais códigos QR de um projeto para outro na mesma conta. |
| Obter a data de melhor desempenho |
Busque a data de melhor desempenho (a maioria das verificações em um único dia) para o código de conta, projeto ou QR. |
| Obter atividade de conta |
Recuperar a atividade da conta: uso dinâmico de QR, limites de verificação mensais e verificações este mês. |
| Obter detalhes da assinatura |
Recupere o plano de assinatura atual, o status, o ciclo de cobrança e a moeda para o usuário autenticado. |
| Obter detalhes do código QR |
Recupere detalhes completos de um código QR específico, incluindo conteúdo, contagem de verificação, URL de visualização e URL de download. |
| Obter histórico de código QR |
Recupere o histórico de alteração e auditoria de um código QR específico. |
| Obter o código QR do scanner superior |
Busque o código QR com a maioria das verificações da conta ou de um projeto específico. |
| Obter o local de melhor desempenho |
Busque o país de melhor desempenho (a maioria das verificações) em busca de conta, projeto ou código QR. |
| Obter perfil de usuário |
Recupere o perfil do usuário autenticado, incluindo nome, email, nome comercial, número de telefone e fuso horário. |
| Obter total de verificações |
Buscar contagem total de verificação para conta, projeto ou código QR específico dentro de um intervalo de datas. |
| Obter usuários exclusivos |
Buscar contagem de scanner exclusiva para conta, projeto ou código QR específico dentro de um intervalo de datas. |
| Obter verificações de conta |
Recupere dados de verificação paginados para toda a conta. Use group_by para agregar por data, país, região ou dispositivo. |
| Obter verificações de código QR |
Recupere logs de verificação paginados para um código QR específico dentro de um intervalo de datas. |
| Obter verificações de Project |
Recupere logs de verificação paginados para um projeto específico dentro de um intervalo de datas. |
| Obter visão geral da conta |
Recupere uma visão geral de análise de alto nível: total de projetos, códigos QR, verificações e usuários exclusivos. |
| Restaurar código QR excluído |
Restaure um ou mais códigos QR excluídos anteriormente para o status ativo. |
| Restaurar Project Excluídos |
Restaure um ou mais projetos excluídos anteriormente para o status ativo. |
| Transferir código QR (anônimo) |
Transferir a propriedade de um código QR criado anonimamente para uma conta e um projeto registrados. |
Atualizar código QR
Atualize a URL de destino, o nome ou o tipo de conteúdo de um código QR existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador de código QR a ser atualizado. |
|
Name
|
name | string |
Novo nome. |
|
|
Dados/URL
|
data | string |
Nova URL de destino ou conteúdo. |
|
|
Tipo
|
type | string |
Tipo de conteúdo de código QR. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do código QR
|
idqrcode | integer |
Identificador de código QR. |
|
Name
|
name | string |
Nome atualizado. |
Carregar Arquivo
Carregue uma imagem ou arquivo de ativo (PNG, JPEG, SVG) para usar como um logotipo ou plano de fundo no estilo de código QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Arquivo
|
file | True | file |
O arquivo de imagem a ser carregado (PNG, JPEG ou SVG). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de Arquivo
|
data.idfs_file | integer |
Identificador de arquivo. |
|
URL do Arquivo
|
data.url | string |
URL para acessar o arquivo carregado. |
Criar Projeto
Crie um novo projeto para organizar códigos QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do projeto
|
name | True | string |
Nome do novo projeto. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do projeto
|
idproject | integer |
Identificador de projeto. |
|
Name
|
name | string |
Project nome. |
Gerar código QR
Gere um novo código QR com o tipo, o conteúdo e as opções de estilo opcionais especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Name
|
name | True | string |
Nome do novo código QR. |
|
Tipo
|
output_type | True | string |
Tipo de conteúdo de código QR. |
|
ID do projeto
|
idproject | True | integer |
Project ID para colocar o código QR. |
|
Dados/Conteúdo
|
data | string |
Conteúdo do código QR (por exemplo, a URL ou o texto). |
|
|
Nome do quadro
|
frame_name | string |
Nome do estilo de quadro. |
|
|
ID da imagem do logotipo
|
qr_code_logo_image | string |
ID da imagem do logotipo a ser inserida no código QR. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do código QR
|
idqrcode | integer |
Novo identificador de código QR. |
|
Name
|
name | string |
Nome do código QR. |
|
URL de visualização
|
preview_url | string |
URL da imagem de visualização. |
|
URL encurtada
|
shorturl | string |
URL de redirecionamento curto. |
Listar códigos QR
Recupere uma lista paginada de códigos QR na conta. Opcionalmente, filtre por consulta de pesquisa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Códigos QR por página (5-100). |
|
|
Consulta de pesquisa
|
q | string |
Pesquise a consulta para filtrar por nome. |
|
|
Ordem de Classificação
|
sort_order | string |
Direção de classificação. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Códigos QR
|
data | array of object | |
|
ID do código QR
|
data.idqrcode | integer |
Identificador de código QR. |
|
Name
|
data.name | string |
Nome do código QR. |
|
Tipo
|
data.output_type | string |
Tipo de código QR. |
|
ID do projeto
|
data.idproject | integer |
ID do Projeto. |
|
URL encurtada
|
data.shorturl | string |
URL curta. |
|
URL de visualização
|
data.preview_url | string |
URL da imagem de visualização. |
|
Página Atual
|
meta.current_page | integer |
Página atual. |
|
Total
|
meta.total | integer |
Total de códigos QR. |
Listar códigos QR no Project
Recupere todos os códigos QR pertencentes a um projeto específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
idproject | True | integer |
O identificador do projeto. |
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Códigos QR por página. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Códigos QR
|
data | array of object | |
|
ID do código QR
|
data.idqrcode | integer |
Identificador de código QR. |
|
Name
|
data.name | string |
Nome do código QR. |
|
Tipo
|
data.output_type | string |
Tipo de código QR. |
|
URL de visualização
|
data.preview_url | string |
URL da imagem de visualização. |
|
Total de verificações
|
data.hits | integer |
Total de verificações. |
Listar projetos
Recupere uma lista paginada de projetos de código QR. Use deleted=1 para listar projetos excluídos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Page
|
page | integer |
Número da página (começa a partir de 1). |
|
|
Por Página
|
per_page | integer |
Projetos por página (5 a 100). |
|
|
Classificar por
|
sort_by | string |
Campo de classificação. |
|
|
Ordem de Classificação
|
sort_order | string |
Direção de classificação. |
|
|
Mostrar Excluído
|
deleted | integer |
Defina como 1 para listar projetos excluídos. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Projetos
|
data | array of object | |
|
ID do projeto
|
data.idproject | integer |
Identificador de projeto. |
|
Name
|
data.name | string |
Project nome. |
|
Contagem de códigos QR
|
data.num_codes | integer |
Número de códigos QR. |
|
Página Atual
|
meta.current_page | integer |
Página atual. |
|
Última página
|
meta.last_page | integer |
Última página. |
|
Total
|
meta.total | integer |
Total de projetos. |
Mover o código QR para Project
Mova um ou mais códigos QR de um projeto para outro na mesma conta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de Project de destino
|
idproject | True | integer |
Identificador de projeto de destino. |
|
IDs de código QR
|
qrcodes | True | array of integer |
Lista de IDs de código QR a serem movidas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
message | string |
Mensagem resultante. |
Obter a data de melhor desempenho
Busque a data de melhor desempenho (a maioria das verificações em um único dia) para o código de conta, projeto ou QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Escopo de análise. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de término
|
end_date | True | string |
Data de término (YYYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
ID do Projeto. |
|
|
ID do código QR
|
idqrcode | integer |
ID do código QR. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Data
|
date | string |
Data máxima. |
|
Scans
|
scans | integer |
Verifica essa data. |
Obter atividade de conta
Recuperar a atividade da conta: uso dinâmico de QR, limites de verificação mensais e verificações este mês.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Códigos QR dinâmicos usados
|
dynamic_qrcodes_used | integer |
Códigos QR dinâmicos usados. |
|
Limite de códigos QR dinâmicos
|
dynamic_qrcodes_limit | integer |
Limite de códigos QR dinâmicos. |
|
Verificações deste mês
|
scans_this_month | integer |
Verifica este mês. |
|
Limite de verificações
|
scans_limit | integer |
Limite de verificação mensal. |
Obter detalhes da assinatura
Recupere o plano de assinatura atual, o status, o ciclo de cobrança e a moeda para o usuário autenticado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Plano
|
plan | string |
Nome do plano de assinatura. |
|
Status
|
status | string |
Status da assinatura (por exemplo, ativo, cancelado). |
|
Data de faturação seguinte
|
next_billing_at | string |
Próxima data de cobrança. |
|
Moeda
|
currency_code | string |
Código de moeda de cobrança (por exemplo, USD). |
Obter detalhes do código QR
Recupere detalhes completos de um código QR específico, incluindo conteúdo, contagem de verificação, URL de visualização e URL de download.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador de código QR. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do código QR
|
idqrcode | integer |
Identificador de código QR. |
|
Name
|
name | string |
Nome do código QR. |
|
Tipo
|
output_type | string |
Tipo de conteúdo de código QR. |
|
ID do projeto
|
idproject | integer |
ID do Projeto. |
|
URL encurtada
|
shorturl | string |
URL curta. |
|
URL de visualização
|
preview_url | string |
URL da imagem de visualização. |
|
Baixar URL
|
download_url | string |
Baixar URL. |
|
Total de verificações
|
hits | integer |
Contagem total de verificação. |
Obter histórico de código QR
Recupere o histórico de alteração e auditoria de um código QR específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador de código QR. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
History
|
data | array of object | |
|
Event
|
data.event | string |
Tipo de evento. |
|
Data
|
data.created_at | string |
Quando o evento ocorreu. |
|
User
|
data.user | string |
Usuário que executou a ação. |
Obter o código QR do scanner superior
Busque o código QR com a maioria das verificações da conta ou de um projeto específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Escopo: conta ou projeto. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de término
|
end_date | True | string |
Data de término (YYYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
ID do Projeto. Necessário quando scope=project. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do código QR
|
idqrcode | integer |
Identificador de código QR. |
|
Name
|
name | string |
Nome do código QR. |
|
Scans
|
scans | integer |
Total de verificações. |
Obter o local de melhor desempenho
Busque o país de melhor desempenho (a maioria das verificações) em busca de conta, projeto ou código QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Escopo de análise. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de término
|
end_date | True | string |
Data de término (YYYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
ID do Projeto. |
|
|
ID do código QR
|
idqrcode | integer |
ID do código QR. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Country
|
country | string |
Nome do país. |
|
Scans
|
scans | integer |
Contagem de verificação. |
Obter perfil de usuário
Recupere o perfil do usuário autenticado, incluindo nome, email, nome comercial, número de telefone e fuso horário.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do cliente
|
idclient | integer |
O identificador de cliente exclusivo. |
|
Primeiro nome
|
first_name | string |
Nome próprio. |
|
Apelido
|
last_name | string |
Apelido. |
|
Nome de usuário
|
username | string |
Endereço de email/nome de usuário. |
|
Nome da empresa
|
business_name | string |
Nome comercial ou de organização. |
|
Número do Telefone
|
phone_number | string |
Número de telefone. |
|
Timezone
|
timezone | string |
Fuso horário do usuário (por exemplo, Ásia/Calcutá). |
Obter total de verificações
Buscar contagem total de verificação para conta, projeto ou código QR específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Escopo de análise. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de término
|
end_date | True | string |
Data de término (YYYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
Project ID (necessária quando scope=project ou qrcode). |
|
|
ID do código QR
|
idqrcode | integer |
ID de código QR (necessária quando scope=qrcode). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Total de verificações
|
total | integer |
Contagem total de verificação. |
Obter usuários exclusivos
Buscar contagem de scanner exclusiva para conta, projeto ou código QR específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Escopo de análise. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de término
|
end_date | True | string |
Data de término (YYYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
Project ID (necessária quando scope=project ou qrcode). |
|
|
ID do código QR
|
idqrcode | integer |
ID de código QR (necessária quando scope=qrcode). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Usuários Exclusivos
|
unique_users | integer |
Contagem de usuários exclusiva. |
Obter verificações de conta
Recupere dados de verificação paginados para toda a conta. Use group_by para agregar por data, país, região ou dispositivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Data de Início
|
start_date | string |
Data de início (YYYY-MM-DD). O padrão é 30 dias atrás. |
|
|
Data de término
|
end_date | string |
Data de término (YYYY-MM-DD). O padrão é hoje. |
|
|
Agrupar por
|
group_by | string |
Agregar por. |
|
|
Country
|
country | string |
Código do país ISO. Necessário quando group_by=região. |
|
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Itens por página. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
Obter verificações de código QR
Recupere logs de verificação paginados para um código QR específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador de código QR. |
|
Data de Início
|
start_date | string |
Data de início (YYYY-MM-DD). |
|
|
Data de término
|
end_date | string |
Data de término (YYYY-MM-DD). |
|
|
Agrupar por
|
group_by | string |
Agrupar resultados por. |
|
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Itens por página. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
Obter verificações de Project
Recupere logs de verificação paginados para um projeto específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
idproject | True | integer |
O identificador do projeto. |
|
Data de Início
|
start_date | string |
Data de início (YYYY-MM-DD). |
|
|
Data de término
|
end_date | string |
Data de término (YYYY-MM-DD). |
|
|
Agrupar por
|
group_by | string |
Agrupar por. |
|
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Itens por página. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
Obter visão geral da conta
Recupere uma visão geral de análise de alto nível: total de projetos, códigos QR, verificações e usuários exclusivos.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Total de projetos
|
total_projects | integer |
Total de projetos. |
|
Total de códigos QR
|
total_qrcodes | integer |
Total de códigos QR. |
|
Total de verificações
|
total_scans | integer |
Total de verificações. |
|
Usuários Exclusivos
|
total_unique_users | integer |
Total de scanners exclusivos. |
Restaurar código QR excluído
Restaure um ou mais códigos QR excluídos anteriormente para o status ativo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
IDs de código QR
|
qrcode_ids | array of integer |
Lista de IDs de código QR a serem restauradas. |
|
|
Chaves de URL Curtas
|
shorturl_keys | array of string |
Lista de chaves de URL curtas a serem restauradas (alternativa às IDs). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
message | string |
Mensagem resultante. |
Restaurar Project Excluídos
Restaure um ou mais projetos excluídos anteriormente para o status ativo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
IDs de projeto
|
project_ids | True | array of integer |
Lista de IDs de projeto a serem restauradas. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
message | string |
Mensagem resultante. |
Transferir código QR (anônimo)
Transferir a propriedade de um código QR criado anonimamente para uma conta e um projeto registrados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
idproject | integer |
ID do projeto de destino. |
|
|
IDs de código QR
|
qrcode_ids | array of integer |
IDs de código QR a serem transferidas. |
|
|
Chaves de URL Curtas
|
shorturl_keys | array of string |
Chaves de URL curtas para transferência (alternativa às IDs). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
message | string |
Mensagem resultante. |