curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
API de gestión — Tokens y uso
Uso por endpoint
GET /console/usage/by-endpoint/
GET
/
console
/
usage
/
by-endpoint
/
curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
Devuelve recuentos de solicitudes agrupados por endpoint y método HTTP — útil para ver qué partes de la API de gestión utiliza realmente una integración. Reside en el host habitual de la API de Scanova (
qcg-api.scanova.io), autenticado con tu token de acceso OAuth del panel.
Solicitud
GET https://qcg-api.scanova.io/console/usage/by-endpoint/
Authorization: Bearer <your_oauth_access_token>
string
requerido
Uno de
sandbox, live, zapier, mcp. Selecciona los registros de qué claves se agregan.curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
Campos de la respuesta
La respuesta es un array, una entrada por cada par distinto(endpoint, method) visto en los registros, ordenado por count de forma descendente.
string
La URL completa de la solicitud registrada, incluyendo el valor real del parámetro de ruta (p. ej. un
qrid específico) — no una plantilla de ruta normalizada. Espera muchas entradas distintas para rutas parametrizadas si las has llamado con IDs diferentes.string
El método HTTP de la solicitud, p. ej.
GET, POST, PUT, DELETE.integer
Total de solicitudes registradas para este par de endpoint/método.
number
Fracción (
0–1) de solicitudes a este par de endpoint/método que devolvieron un código de estado de 400 o superior.A diferencia de Estadísticas de uso y Uso diario, este endpoint no tiene una ventana de
period/days — agrega sobre todo el periodo de retención de registros (los registros de solicitudes se purgan después de 6 meses).Errores
environment es obligatorio, con la misma validación que Estadísticas de uso.
Relacionado
- Estadísticas de uso — el mismo tráfico como un único total de ventana móvil en lugar de un desglose por endpoint.
- Uso diario — el mismo tráfico desglosado por día del calendario en lugar de por ruta.
- Resumen de la API de gestión — los valores de
environment(sandbox,live,zapier,mcp) por los que agrega este endpoint.
Autorizaciones
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.
Parámetros de consulta
Respuesta
200
Usage grouped by endpoint
¿Esta página le ayudó?
⌘I