Dinaup DocsUso de la API
Cuánto usa la API cada clave, app y función, qué peticiones se rechazan por ritmo o por cola, cómo va cada clave frente a sus límites y qué cuesta el ancho de banda.
Administración → Uso de la API dice cuánto usa la API de tu empresa cada clave, con qué coste y cómo de cerca está de sus límites. Solo la ve un Administrador. El uso desde Play no cuenta.
Elige el periodo arriba. Los rangos cortos (últimos 5 minutos, última hora y últimas 3 horas) se leen minuto a minuto y se actualizan solos cada minuto.
Consumo
Filtra por Clave, App, Función e IP, y con Comparar separa la evolución en una línea por clave, app, función o IP.
| Cifra | Qué cuenta |
|---|---|
| Peticiones | Las peticiones atendidas en el periodo. |
| Ritmo medio | Peticiones por segundo de media. |
| Errores | Las peticiones que acabaron en error. |
| Rechazadas por ritmo | No atendidas con 429: la clave pasó de su ritmo. |
| Rechazadas por cola | No atendidas con 503: la cola de la clave estaba llena o la espera se agotó. |
| Media | Lo que tarda una petición de media. |
| Tiempo de servidor | La suma de lo que han tardado todas. |
| Datos enviados | Lo que el Servidor ha respondido. |
| Escrituras | Los registros creados o cambiados. |
Debajo:
- Evolución: la métrica que elijas (Peticiones, Tiempo medio, Tiempo de servidor, Datos enviados, Errores, Rechazadas por ritmo o Rechazadas por cola) a lo largo del periodo.
- Coste por petición: milisegundos, KB y filas por petición, para ver qué llamadas pesan más.
- Cuándo se usa: las peticiones por hora y día de la semana.
- Por clave, app y función: la tabla con todo el detalle, con su tendencia.
Si sale el aviso de que el periodo tiene demasiado uso, las cifras se quedan cortas: elige un periodo más corto.
Límites
Cada clave tiene dos límites, y la empresa entera otros dos:
| Límite | Qué es | Al superarlo |
|---|---|---|
| vCores | Las peticiones que la clave atiende a la vez. En su tarjeta sale como ×4; ×∞ es sin tope. | Las demás esperan en cola. Con la cola llena, 503. |
| Ritmo | Las peticiones por segundo que puede hacer la clave, según sus vCPUs. Solo existe si Dinaup lo fija en tu licencia. | 429 con Retry-After. |
Si la licencia no tiene límite de ritmo, la pestaña lo dice arriba y solo cuentan los vCores.
Cada tarjeta, Toda la empresa y una por clave, enseña lo que pasa ahora y se pone al día cada 3 segundos:
| Dato | Qué dice |
|---|---|
| Derechos | Las peticiones que la clave puede hacer seguidas sin que la frenen. Cada petición gasta uno y se recuperan al ritmo de la clave. Vacío, la siguiente recibe 429. |
| Atendiendo | Las peticiones en curso, sobre sus vCores. |
| En cola | Las que esperan turno. |
| Pico | El segundo más cargado del periodo, y qué parte del ritmo es. Con aviso, los minutos que la clave ha estado por encima de su ritmo. |
Ritmo frente al límite dibuja el minuto más cargado de cada hora, con el límite en línea discontinua. Una clave que lo toca a menudo necesita más vCPUs en su ficha, o repartir mejor sus llamadas.
Uso responsable
Pide solo lo que ha cambiado desde la última vez, reparte los lotes grandes en el tiempo y, con un 429, espera los segundos de Retry-After antes de repetir. Una clave que hace un uso abusivo se puede limitar o suspender: Política de uso responsable.
En vídeo: Protege tus integraciones: límite de ritmo y límite de tiempo por clave API.
Ancho de banda
Lo que la API ha enviado y recibido, y lo que cuesta: Datos enviados, Recibidos, Coste del periodo y Al mes, a este ritmo (el coste del periodo llevado a 30 días). Las tablas Por clave y Por clave, app y función dicen quién envía más y cuánto pesa cada petición.
El precio es 0,126 € por GB enviado. Lo recibido no se cobra.
Ver también
- Límites de la API: los códigos y las cabeceras de cada límite.
- Claves API: crear una clave y ajustar sus límites.