Limites do plano e notificações
Todos os limites de todos os planos estão detalhados na matriz de planos na página de preços. Ela vem da mesma fonte que a API utiliza para aplicar os limites. De forma legível por máquina, GET /v1/billing/plans fornece os mesmos valores, além do comportamento em cada limite sob meta.limit_behavior.
O que é contabilizado
- Códigos dinâmicos – códigos editáveis cujo destino pode ser alterado. Códigos estáticos (ex: Wi-Fi, vCard) são ilimitados e não contam para este limite.
- Leituras por mês – em toda a organização, somando todos os Workspaces, por mês civil (UTC).
- DPPs – os Passaportes Digitais de Produto da sua organização, incluindo os criados por importação.
- Vagas de equipe e Workspaces – quantos membros e Workspaces sua organização pode ter.
Você pode ver o consumo atual a qualquer momento em Dashboard → Equipe.
O que acontece em um limite
| Limite | O que acontece | Resposta da API |
|---|---|---|
| Leituras por mês | As leituras continuam sendo contabilizadas e nunca são bloqueadas. Você recebe e-mails de aviso a 80%, 90% e 100%. | – |
| Códigos dinâmicos, DPPs, Workspaces, vagas de equipe | A criação acima do limite é rejeitada. Os códigos e passaportes existentes continuam funcionando. | 422 plan-limit |
| Webhooks e metas A/B (a partir do Pro), leitura de logs de auditoria (a partir do Business) | A criação, ativação ou leitura é rejeitada. O que já existe permanece editável após um downgrade. | 422 plan-limit |
| Códigos por requisição em lote, linhas por arquivo de importação, arquivos por código | A requisição excessivamente grande é rejeitada. | 422 plan-limit |
| DPPs por requisição em lote (100) | A requisição excessivamente grande é rejeitada. | 422 validation |
| Tamanho do arquivo | O arquivo excessivamente grande é rejeitado. | 413 file-too-large |
| Armazenamento por Workspace ou por DPP | O upload que excederia o armazenamento é rejeitado. | 422 storage-limit-exceeded |
| 60 requisições de API por minuto por chave de API, todos os planos | A requisição é rejeitada, com Retry-After: 60. | 429 rate-limited |
| 200 novos códigos por dia individualmente, 10.000 por lote, por Workspace, todos os planos | Códigos adicionais só serão possíveis no dia seguinte (UTC). | 429 rate-limit |
Plano Free
No plano Free, cada leitura exibe brevemente uma página do qr3 antes de redirecionar. A partir do Pro, o redirecionamento vai diretamente para o destino.
Upgrade
Você pode fazer o upgrade a qualquer momento na área de faturamento. Quais limites mudam com cada plano está detalhado na matriz de planos; nem todo limite aumenta com cada plano (o Pro, por exemplo, tem apenas um Workspace, assim como o Free).