> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Analyses des QR codes
> POST /analytics/qr/
Renvoie des analyses de scans agrégées pour un ou plusieurs QR codes, regroupées selon le ou les types de métrique que vous demandez.
Il s'agit d'un endpoint **POST uniquement** malgré ce que son nom pourrait laisser penser — une requête `GET` renvoie `405 Method Not Allowed`. Les paramètres de requête (`from`, `to`, `type`) sélectionnent la plage de dates et les métriques ; le corps de la requête sélectionne les QR codes à inclure.
Nécessite une clé Management API avec le quota `MANAGEMENT_API` (ou `MANAGEMENT_API_SANDBOX`) — voir la [vue d'ensemble de la Management API](/fr/api-reference/management-api/overview) — ainsi que le propre quota `QR_ANALYTICS_BASIC` du compte. Demander autre chose que la métrique `count` nécessite en plus `QR_ANALYTICS_ADVANCED` ; sans cela, chaque requête est silencieusement rétrogradée vers `count`, quel que soit le `type` demandé.
## Requête
```bash cURL theme={null}
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/?from=2026-07-01&to=2026-08-16&type=qr' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}'
```
```json 200 theme={null}
{
"qr": [],
"qr_meta": {
"docs-v2-first-qr-code": {
"qrid": "Q07afe81aa0034c01",
"category": "Website URL",
"category_slug": "url"
}
}
}
```
Vérifié en conditions réelles — un tableau `qr` vide ici reflète un QR code n'ayant reçu aucun scan sur la période demandée, et non une erreur. `qr_meta` est une carte supplémentaire `name -> {qrid, category, category_slug}`, ajoutée uniquement lorsque `qr` fait partie des `type` demandés, afin qu'un appelant puisse créer un lien profond depuis une ligne indexée par nom vers son `qrid`. C'est additif : la structure que les appelants analysent déjà sous chaque clé de métrique reste inchangée.
### Paramètres de requête
Date de début (`YYYY-MM-DD`), incluse.
Date de fin (`YYYY-MM-DD`), incluse.
Types de métrique séparés par des virgules, par ex. `qr,device,geography`. Valeurs courantes : `count`, `qr`, `date`, `day`, `time`, `utm`, `device`, `os`, `browser`, `handset`, `geography`, `geo_location`, `age`. Nécessite le quota `QR_ANALYTICS_ADVANCED` du compte pour toute métrique autre que `count`.
Regroupement pour les types de métrique en série temporelle, par ex. `date`, `week`, `month`.
Exclut des résultats les scans identifiés comme du trafic de bots.
Passez `true` pour les appels de type vue d'ensemble du tableau de bord — contourne la limite de volume QR codes/plage de dates décrite ci-dessous, et ne compte pas dans le signal d'activité « analyses récupérées » du compte.
### Corps de la requête
Liste d'identifiants pour délimiter les analyses — le type d'identifiant dépend de `filter_by`.
L'un de `qrid` (identifiants de QR codes), `id` (identifiants numériques internes), `tags` (noms de tags) ou `folder` (identifiants de dossiers).
### Réponse
La réponse est un objet indexé par chaque `type` de métrique demandé, plus `qr_meta` le cas échéant (voir ci-dessus). La structure varie selon le type de métrique — `count` renvoie des totaux de scans, `device`/`os`/`browser`/`geography` renvoient des répartitions selon cette dimension, et les types en série temporelle (`date`/`day`/`time`) renvoient une série regroupée selon `group`.
Demander trop de QR codes sur une plage de dates trop large renvoie une erreur `400` sous `q` : « High Volume of data. Either select lower than {N} QR Codes/{N} days time period or generate Analytics Export instead. » En pratique, [Exporter les analyses](/fr/api-reference/management-api/analytics/export) et [Exporter les analyses brutes](/fr/api-reference/management-api/analytics/export-raw) appliquent tous deux exactement la même limite — les trois endpoints partagent le même chemin de code de validation des requêtes — donc la véritable solution à cette erreur est de réduire `q` ou la plage de dates, et non de changer d'endpoint.
## Voir aussi
* [Exporter les analyses](/fr/api-reference/management-api/analytics/export) — téléchargez le même type de métriques agrégées sous forme de fichier plutôt qu'une réponse JSON.
* [Exporter les analyses brutes](/fr/api-reference/management-api/analytics/export-raw) — téléchargez des enregistrements de scans ligne par ligne plutôt que des répartitions agrégées.
* [Vue d'ensemble de la Management API](/fr/api-reference/management-api/overview) — le schéma d'authentification et l'architecture de quotas dont fait partie cet endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json POST /analytics/qr/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
plans, shared users & roles), plus the token-creation and usage-stats
endpoints used to authenticate against it. Every path and request/response
shape below was verified live against a real API key and the actual running
backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://management.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/analytics/qr/:
post:
summary: QR analytics
description: >-
Returns aggregated analytics data. Requires `from` and `to` as query
parameters (dates) and a `type` query parameter (comma-separated metric
types, e.g. `qr`). The request body selects which QR codes to include
via `q` (a list of identifiers) and `filter_by` (which identifier type
`q` contains — `qrid` is the default; `tags`, `id`, and `folder` are
also supported). Requesting too many QR codes over too wide a date range
returns a 400 under `q` — the same volume cap applies to
/analytics/qr/export/ and /analytics/qr/raw/, which share this
endpoint's request-validation code.
operationId: getManagedQrAnalytics
parameters:
- name: from
in: query
required: true
schema:
type: string
format: date
- name: to
in: query
required: true
schema:
type: string
format: date
- name: type
in: query
required: true
schema:
type: string
description: Comma-separated metric types, e.g. `qr`.
- name: group
in: query
schema:
type: string
default: date
description: Grouping for time-series metric types, e.g. date/week/month.
- name: exclude_bot_scan
in: query
schema:
type: boolean
default: false
- name: overview
in: query
schema:
type: boolean
description: Bypasses the volume cap; used by dashboard overview widgets.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
q:
type: array
items:
type: string
description: >-
Query data — a list of identifiers of the type named in
filter_by.
filter_by:
type: string
enum:
- qrid
- tags
- id
- folder
default: qrid
required:
- q
example:
q:
- Q07afe81aa0034c01
filter_by: qrid
responses:
'200':
description: >-
Analytics data, grouped by the requested type(s). A `qr_meta`
name->{qrid, category, category_slug} map is attached whenever `qr`
is among the requested types.
content:
application/json:
example:
qr: []
qr_meta:
docs-v2-first-qr-code:
qrid: Q07afe81aa0034c01
category: Website URL
category_slug: url
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Send your Management API key as the raw value of the Authorization
header — no "Bearer " or "Token " prefix, and no other characters.
Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
header containing more than one space-separated part is rejected
outright. Requests also require the request's Host header to be the
management API host (e.g. management.scanova.io) — the same key sent to
the regular API host will not authenticate.
````