QRStuff (Pré-visualização)
O QRStuff é uma plataforma profissional de códigos QR. Gera códigos QR dinâmicos e estáticos, gere projetos, acompanhe análises de análise em tempo real por data, país, região e dispositivo, carregue ativos de branding e gere a sua conta.
Este conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões Azure Government - 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 (CCG) - 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 (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contact | |
|---|---|
| Name | Suporte ao QRStuff |
| URL | https://www.qrstuff.com/contact |
| support@qrstuff.com |
| Metadados do conector | |
|---|---|
| Publisher | QRStuff |
| Website | https://www.qrstuff.com |
| Política de privacidade | https://www.qrstuff.com/privacy-policy |
| Categories | Produtividade; Comercialização |
QRStuff
Publisher: QRStuff
O QRStuff é uma plataforma profissional de gestão de códigos QR que permite aos utilizadores gerar códigos QR dinâmicos e estáticos, organizá-los em projetos, acompanhar análises de análise em tempo real e gerir definições de contas. Com este conector pode automatizar fluxos de trabalho de código QR diretamente em todas as suas aplicações e fluxos empresariais.
Prerequisites
Para usar este conector precisa de:
- Uma conta QRStuff (inscreva-se gratuitamente no qrstuff.com)
- Uma subscrição QRStuff paga para aceder a funcionalidades dinâmicas de gestão e análise de códigos QR
Operações suportadas
| Operation | Category | Description |
|---|---|---|
| Obter Perfil de Utilizador | Account | Recuperar nome, email, nome da empresa, telefone e fuso horário |
| Obtenha Detalhes da Subscrição | Account | Recuperar o plano atual, estado e informações de faturação |
| Listar Projetos | Projetos | Liste todos os projetos com código QR com paginação |
| Criar projeto | Projetos | Criar um novo projeto para organizar os códigos QR |
| Lista de Projetos Eliminados | Projetos | Liste projetos apagados suavemente que podem ser restaurados |
| Restaurar Project Eliminado | Projetos | Restaurar um projeto previamente eliminado |
| Lista de Códigos QR | Códigos QR | Liste códigos QR por toda a conta com pesquisa e paginação |
| Gerar Código QR | Códigos QR | Crie um novo código QR com tipo, conteúdo e estilo |
| Obtenha Detalhes do Código QR | Códigos QR | Detalhes completos, incluindo contagem de digitalizações, URL de pré-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 o Código QR Eliminado | Códigos QR | Restaurar um código QR anteriormente apagado |
| Mover o Código QR para o Project | Códigos QR | Mover um código QR de um projeto para outro |
| Código QR de Transferência | Códigos QR | Transfira um código QR anónimo para uma conta registada |
| Obtenha Histórico de Códigos QR | Códigos QR | Histórico de alterações e auditorias para um código QR específico |
| Carregar arquivo | Ficheiros | Carregue uma imagem para usar como código QR, logótipo ou fundo |
| Obter Visão Geral da Conta | Análise | Projetos totais, códigos QR, digitalizações e utilizadores únicos |
| Obter Atividade da Conta | Análise | Uso dinâmico de QR, limites mensais de digitalização, digitalizações este mês |
| Obtenha Scans Totais | Análise | Contagem total de scans para conta, projeto ou código QR |
| Obtenha Utilizadores Únicos | Análise | Contagem única de scanners para conta, projeto ou código QR |
| Obtenha a Data de Melhor Atuação | Análise | Dia com mais exames num determinado período |
| Obtém o Melhor Desempenho do Local | Análise | País com mais exames num determinado período |
| Obtenha o Código QR Top Scanner | Análise | Código QR com mais digitalizações para conta ou projeto |
| Faça Scans de Conta | Análise | Dados de varrimento paginados agrupados por varredura, data, país, região ou dispositivo |
| Obtenha Project Scans | Análise | Registos de varrimento paginados para um projeto específico |
| Obtenha Scans de Códigos QR | Análise | Registos de digitalização paginados para um código QR específico |
| Obtenha Exames por Data | Análise | Contagens de scans agrupadas por data |
| Faça Scans por País | Análise | Contagens de varrimentos agrupadas por país |
| Obtenha Digitalizações por Região | Análise | Contagens de varrimentos agrupadas por região dentro de um país |
| Faça Scans por Dispositivo | Análise | Contagens de varrimento agrupadas por plataforma de dispositivo |
| Criar Pedido de Suporte | Support | Submeta um pedido de suporte à equipa do QRStuff |
| Obtenha URL de Avaliação do Trustpilot | Support | Obtenha o link personalizado de avaliação do Trustpilot |
| Pesquisa na Base de Conhecimento | Support | Pesquise artigos de ajuda e perguntas frequentes no QRStuff |
Obtenção de credenciais
Para Utilizadores Finais
- Inicie sessão na sua conta QRStuff no app.qrstuff.com.
- Quando adicionar este conector no Power Apps ou Power Automate, clique em Iniciar Sessão.
- Será redirecionado para a página de login do QRStuff OAuth.
- Introduza o seu email e palavra-passe do QRStuff e clique em Autorizar.
- Será redirecionado de volta e a ligação será estabelecida automaticamente.
Não é necessária qualquer chave API ou configuração manual do token — o conector usa OAuth 2.0 com atualização automática do token.
Para a Equipa de Certificação Microsoft (Registo de Aplicações OAuth)
Este conector utiliza o RFC 7591 Dynamic Client Registration (DCR) para registar clientes OAuth. Para obter um ID de Cliente válido e um Segredo do Cliente para implementação, envie um pedido POST para o endpoint de registo QRStuff:
-
Ponto final:
https://api.qrstuff.com/api/oauth/register -
Método:
POST -
Cabeçalhos:
Content-Type: application/jsonAccept: application/json
-
Órgão do pedido:
{ "client_name": "QRStuff Power Platform Connector", "redirect_uris": ["https://global.consent.azure-apim.net/redirect"] }
A resposta devolverá o client_id e client_secret para ser configurado nos ambientes de produção da Microsoft Power Platform.
Problemas conhecidos e limitações
- A geração de novos códigos QR (POST para criar) é suportada através da plataforma web QRStuff ou servidor MCP. Este conector foca-se na leitura, atualização e gestão de códigos QR e projetos existentes.
- A gestão dinâmica de códigos QR requer uma subscrição ativa paga.
- Os endpoints de análise (análises por data, país, dispositivo) estão disponíveis através do conector QRStuff MCP Server para fluxos de trabalho assistidos por IA.
Perguntas Mais Frequentes
P: É necessário um plano pago?
R: Uma conta gratuita permite-lhe ler dados de perfis e projetos. A gestão dinâmica e análise de códigos QR exige um plano pago.
P: Onde posso obter apoio?
R: Contacte o suporte da QRStuff por qrstuff.com/contact ou por email support@qrstuff.com.
P: Que regiões são suportadas?
R: A API do QRStuff está disponível globalmente através api.qrstuff.comde .
Ações
| Atualizar Código QR |
Atualize a URL de destino, nome ou tipo de conteúdo de um código QR existente. |
| Carregar ficheiro |
Carregue uma imagem ou ficheiro de asset (PNG, JPEG, SVG) para usar como logótipo ou fundo no estilo de código QR. |
| Criar projeto |
Crie um novo projeto para organizar códigos QR. |
| Faça Scans de Conta |
Recuperar os dados de digitalização paginados de toda a conta. Use group_by para agregar por data, país, região ou dispositivo. |
| Gerar Código QR |
Gera um novo código QR com o tipo, conteúdo e opções de estilo opcionais especificados. |
| Lista de Códigos QR |
Recupere uma lista paginada de códigos QR espalhados pela conta. Opcionalmente, filtra 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 com código QR. Use deleted=1 para listar projetos eliminados. |
| Mover o Código QR para o Project |
Mover um ou mais códigos QR de um projeto para outro na mesma conta. |
| Obtenha a Data de Melhor Atuação |
Obtenha a data com melhor desempenho (maior número de digitalizações num só dia) para o código da conta, projeto ou QR. |
| Obtenha Detalhes da Subscrição |
Recupere o plano de subscrição atual, o estado, o ciclo de faturação e a moeda do utilizador autenticado. |
| Obtenha Detalhes do Código QR |
Recupere todos os detalhes de um código QR específico, incluindo conteúdo, contagem de análises, URL de pré-visualização e URL de download. |
| Obtenha Histórico de Códigos QR |
Recupere o histórico de alterações e auditorias de um código QR específico. |
| Obtenha o Código QR Top Scanner |
Obtém o QR code com mais scans para a conta ou para um projeto específico. |
| Obtenha Project Scans |
Recuperar registos de varrimento paginados de um projeto específico dentro de um intervalo de datas. |
| Obtenha Scans de Códigos QR |
Recupere registos de digitalização paginados para um código QR específico dentro de um intervalo de datas. |
| Obtenha Scans Totais |
Buscar a contagem total de digitalização para conta, projeto ou código QR específico dentro de um intervalo de datas. |
| Obtenha Utilizadores Únicos |
Obtém a contagem única de scanners para conta, projeto ou código QR específico dentro de um intervalo de datas. |
| Obter Atividade da Conta |
Recuperar atividade da conta: uso dinâmico de QR, limites mensais de análise e digitalizações este mês. |
| Obter perfil de usuário |
Recupere o perfil do utilizador autenticado, incluindo nome, email, nome da empresa, número de telefone e fuso horário. |
| Obter Visão Geral da Conta |
Obtenha uma visão geral de análises de alto nível: projetos totais, códigos QR, digitalizações e utilizadores únicos. |
| Obtém o Melhor Desempenho do Local |
Obtenha o país com melhor desempenho (mais digitalizações) para obter código de conta, projeto ou QR. |
| Restaurar o Código QR Eliminado |
Restaurar um ou mais códigos QR previamente apagados suavemente para o estado ativo. |
| Restaurar Project Eliminado |
Restaurar um ou mais projetos previamente apagados de forma suave para o estado ativo. |
| Transferir Código QR (Anónimo) |
Transfira a propriedade de um código QR criado anonimamente para uma conta registada e projeto. |
Atualizar Código QR
Atualize a URL de destino, nome ou tipo de conteúdo de um código QR existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador do código QR para atualizar. |
|
Name
|
name | string |
Novo nome. |
|
|
Dados / URL
|
data | string |
Novo URL de destino ou conteúdo. |
|
|
Tipo
|
type | string |
Tipo de conteúdo do código QR. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do código QR
|
idqrcode | integer |
Identificador de código QR. |
|
Name
|
name | string |
Nome atualizado. |
Carregar ficheiro
Carregue uma imagem ou ficheiro de asset (PNG, JPEG, SVG) para usar como logótipo ou fundo no estilo de código QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Ficheiro
|
file | True | file |
O ficheiro de imagem a carregar (PNG, JPEG ou SVG). |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do ficheiro
|
data.idfs_file | integer |
Identificador do ficheiro. |
|
URL do ficheiro
|
data.url | string |
URL para aceder ao ficheiro carregado. |
Criar projeto
Crie um novo projeto para organizar códigos QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome do Projeto
|
name | True | string |
Nome para o novo projeto. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do projeto
|
idproject | integer |
Identificador do projeto. |
|
Name
|
name | string |
Nome do projeto. |
Faça Scans de Conta
Recuperar os dados de digitalização paginados de toda a conta. Use group_by para agregar por data, país, região ou dispositivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Data de Início
|
start_date | string |
Data de início (YYYY-MM-DD). Por defeito, há 30 dias. |
|
|
Data de Fim
|
end_date | string |
Data de fim (YYY-MM-DD). Por defeito, é hoje. |
|
|
Agrupar por
|
group_by | string |
Agregar por. |
|
|
País
|
country | string |
Código ISO do país. Obrigatório quando group_by=região. |
|
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Itens por página. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
Gerar Código QR
Gera um novo código QR com o tipo, conteúdo e opções de estilo opcionais especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Name
|
name | True | string |
Nome para o novo código QR. |
|
Tipo
|
output_type | True | string |
Tipo de conteúdo do código QR. |
|
ID do projeto
|
idproject | True | integer |
ID do Project para colocar o código QR. |
|
Dados / Conteúdo
|
data | string |
Conteúdo para o código QR (por exemplo, o URL ou texto). |
|
|
Nome da Estrutura
|
frame_name | string |
Nome do estilo do quadro. |
|
|
ID de imagem do logótipo
|
qr_code_logo_image | string |
ID de imagem do logótipo para incorporar no código QR. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do código QR
|
idqrcode | integer |
Novo identificador de código QR. |
|
Name
|
name | string |
Nome do código QR. |
|
URL de pré-visualização
|
preview_url | string |
URL da imagem de pré-visualização. |
|
URL curto
|
shorturl | string |
URL de redirecionamento curto. |
Lista de Códigos QR
Recupere uma lista paginada de códigos QR espalhados pela conta. Opcionalmente, filtra por consulta de pesquisa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
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 |
Pesquisa para filtrar por nome. |
|
|
Ordem de classificação
|
sort_order | string |
Direção de classificação. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
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 curto
|
data.shorturl | string |
URL curto. |
|
URL de pré-visualização
|
data.preview_url | string |
URL da imagem de pré-visualização. |
|
Página Atual
|
meta.current_page | integer |
Página atual. |
|
Total
|
meta.total | integer |
Códigos QR totais. |
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 | Descrição |
|---|---|---|---|---|
|
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. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
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 pré-visualização
|
data.preview_url | string |
URL da imagem de pré-visualização. |
|
Scans Totais
|
data.hits | integer |
Exames totais. |
Listar Projetos
Recupere uma lista paginada de projetos com código QR. Use deleted=1 para listar projetos eliminados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Page
|
page | integer |
Número de página (começa em 1). |
|
|
Por Página
|
per_page | integer |
Projetos por página (5-100). |
|
|
Ordenar Por
|
sort_by | string |
Campo Ordenar. |
|
|
Ordem de classificação
|
sort_order | string |
Direção de classificação. |
|
|
Programa Eliminado
|
deleted | integer |
Defina para 1 para listar os projetos apagados. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Projetos
|
data | array of object | |
|
ID do projeto
|
data.idproject | integer |
Identificador do projeto. |
|
Name
|
data.name | string |
Nome do projeto. |
|
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 |
Projetos totais. |
Mover o Código QR para o Project
Mover um ou mais códigos QR de um projeto para outro na mesma conta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do Project de Destino
|
idproject | True | integer |
Identificador de projeto de destino. |
|
IDs de códigos QR
|
qrcodes | True | array of integer |
Lista de IDs de códigos QR para mover. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Message
|
message | string |
Mensagem do resultado. |
Obtenha a Data de Melhor Atuação
Obtenha a data com melhor desempenho (maior número de digitalizações num só dia) para o código da conta, projeto ou QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Âmbito analítico. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de Fim
|
end_date | True | string |
Data de fim (YYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
ID do projeto. |
|
|
ID do código QR
|
idqrcode | integer |
ID com código QR. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Data
|
date | string |
Data principal. |
|
Scans
|
scans | integer |
Exames nessa data. |
Obtenha Detalhes da Subscrição
Recupere o plano de subscrição atual, o estado, o ciclo de faturação e a moeda do utilizador autenticado.
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Plano
|
plan | string |
Nome do plano de subscrição. |
|
Status
|
status | string |
Estado da subscrição (por exemplo, ativo, cancelado). |
|
Próxima Data de Faturação
|
next_billing_at | string |
Próxima data de faturação. |
|
Moeda
|
currency_code | string |
Código de moeda de faturação (por exemplo, USD). |
Obtenha Detalhes do Código QR
Recupere todos os detalhes de um código QR específico, incluindo conteúdo, contagem de análises, URL de pré-visualização e URL de download.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador do código QR. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
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 do código QR. |
|
ID do projeto
|
idproject | integer |
ID do projeto. |
|
URL curto
|
shorturl | string |
URL curto. |
|
URL de pré-visualização
|
preview_url | string |
URL da imagem de pré-visualização. |
|
URL de download
|
download_url | string |
URL de download. |
|
Scans Totais
|
hits | integer |
Contagem total de digitalizações. |
Obtenha Histórico de Códigos QR
Recupere o histórico de alterações e auditorias de um código QR específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador do código QR. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
History
|
data | array of object | |
|
Event
|
data.event | string |
Tipo de evento. |
|
Data
|
data.created_at | string |
Quando o evento aconteceu. |
|
User
|
data.user | string |
Utilizador que realizou a ação. |
Obtenha o Código QR Top Scanner
Obtém o QR code com mais scans para a conta ou para um projeto específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Âmbito: conta ou projeto. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de Fim
|
end_date | True | string |
Data de fim (YYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
ID do projeto. Obrigatório quando âmbito = projeto. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do código QR
|
idqrcode | integer |
Identificador de código QR. |
|
Name
|
name | string |
Nome do código QR. |
|
Scans
|
scans | integer |
Exames totais. |
Obtenha Project Scans
Recuperar registos de varrimento paginados de um projeto específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
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 Fim
|
end_date | string |
Data de fim (YYY-MM-DD). |
|
|
Agrupar por
|
group_by | string |
Agrupa por. |
|
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Itens por página. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
Obtenha Scans de Códigos QR
Recupere registos de digitalização paginados para um código QR específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do código QR
|
idqrcode | True | integer |
O identificador do código QR. |
|
Data de Início
|
start_date | string |
Data de início (YYYY-MM-DD). |
|
|
Data de Fim
|
end_date | string |
Data de fim (YYY-MM-DD). |
|
|
Agrupar por
|
group_by | string |
Resultados em grupo por. |
|
|
Page
|
page | integer |
Número da página. |
|
|
Por Página
|
per_page | integer |
Itens por página. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Scans
|
data | array of object | |
|
items
|
data | object | |
|
Pagination
|
meta | object |
Obtenha Scans Totais
Buscar a contagem total de digitalização para conta, projeto ou código QR específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Âmbito analítico. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de Fim
|
end_date | True | string |
Data de fim (YYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
Project ID (necessário quando scope=project ou qrcode). |
|
|
ID do código QR
|
idqrcode | integer |
ID do código QR (necessário quando scope = qrcode). |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Scans Totais
|
total | integer |
Contagem total de digitalizações. |
Obtenha Utilizadores Únicos
Obtém a contagem única de scanners para conta, projeto ou código QR específico dentro de um intervalo de datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Âmbito analítico. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de Fim
|
end_date | True | string |
Data de fim (YYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
Project ID (necessário quando scope=project ou qrcode). |
|
|
ID do código QR
|
idqrcode | integer |
ID do código QR (necessário quando scope = qrcode). |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Utilizadores Únicos
|
unique_users | integer |
Número único de utilizadores. |
Obter Atividade da Conta
Recuperar atividade da conta: uso dinâmico de QR, limites mensais de análise e digitalizações este mês.
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Códigos QR Dinâmicos Usados
|
dynamic_qrcodes_used | integer |
Códigos QR dinâmicos usados. |
|
Limite Dinâmico de Códigos QR
|
dynamic_qrcodes_limit | integer |
Limite de códigos QR dinâmicos. |
|
Exames Este Mês
|
scans_this_month | integer |
Exames este mês. |
|
Limite de Varreduras
|
scans_limit | integer |
Limite mensal de exames. |
Obter perfil de usuário
Recupere o perfil do utilizador autenticado, incluindo nome, email, nome da empresa, número de telefone e fuso horário.
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID de Cliente
|
idclient | integer |
O identificador único do cliente. |
|
Nome Próprio
|
first_name | string |
Nome próprio. |
|
Apelido
|
last_name | string |
Apelido. |
|
Nome de utilizador
|
username | string |
Endereço de email / nome de utilizador. |
|
Nome da Empresa
|
business_name | string |
Nome da empresa ou da organização. |
|
Número de Telefone
|
phone_number | string |
Número de telefone. |
|
Timezone
|
timezone | string |
Fuso horário do utilizador (por exemplo, Ásia/Calcutá). |
Obter Visão Geral da Conta
Obtenha uma visão geral de análises de alto nível: projetos totais, códigos QR, digitalizações e utilizadores únicos.
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Total de Projetos
|
total_projects | integer |
Projetos totais. |
|
Códigos QR Totais
|
total_qrcodes | integer |
Códigos QR totais. |
|
Scans Totais
|
total_scans | integer |
Exames totais. |
|
Utilizadores Únicos
|
total_unique_users | integer |
Scanners totalmente únicos. |
Obtém o Melhor Desempenho do Local
Obtenha o país com melhor desempenho (mais digitalizações) para obter código de conta, projeto ou QR.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Scope
|
scope | True | string |
Âmbito analítico. |
|
Data de Início
|
start_date | True | string |
Data de início (YYYY-MM-DD). |
|
Data de Fim
|
end_date | True | string |
Data de fim (YYY-MM-DD). |
|
ID do projeto
|
idproject | integer |
ID do projeto. |
|
|
ID do código QR
|
idqrcode | integer |
ID com código QR. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
País
|
country | string |
Nome do país. |
|
Scans
|
scans | integer |
Contagem de scans. |
Restaurar o Código QR Eliminado
Restaurar um ou mais códigos QR previamente apagados suavemente para o estado ativo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
IDs de códigos QR
|
qrcode_ids | array of integer |
Lista de IDs de código QR para restaurar. |
|
|
Chaves de URL Curtas
|
shorturl_keys | array of string |
Lista de chaves de URL curtas a restaurar (alternativa aos IDs). |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Message
|
message | string |
Mensagem do resultado. |
Restaurar Project Eliminado
Restaurar um ou mais projetos previamente apagados de forma suave para o estado ativo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
IDs do projeto
|
project_ids | True | array of integer |
Lista de IDs de projetos a restaurar. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Message
|
message | string |
Mensagem do resultado. |
Transferir Código QR (Anónimo)
Transfira a propriedade de um código QR criado anonimamente para uma conta registada e projeto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do projeto
|
idproject | integer |
ID do projeto alvo. |
|
|
IDs de códigos QR
|
qrcode_ids | array of integer |
Códigos QR IDs para transferir. |
|
|
Chaves de URL Curtas
|
shorturl_keys | array of string |
Chaves de URL curtas para transferir (alternativa aos IDs). |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Message
|
message | string |
Mensagem do resultado. |