Límites y errores
El límite de subidas, el tamaño de archivo, los créditos y qué significa cada código de estado.
Descripción general
La API tiene unos pocos límites, pensados para que una integración muy activa no deje sin sitio a las demás. Esta página los recoge y después explica cada código de estado que devuelve la API y qué hacer en cada caso.
Cuando una petición falla, el campo Msg de la respuesta explica el motivo con palabras sencillas. Guárdalo en tus registros: suele ser el camino más rápido para arreglarlo.
Límites
| Límite | Cantidad |
|---|---|
| Subidas | 100 por organización en cualquier periodo de 24 horas |
| Tamaño de archivo | 512 MB por subida |
| Columnas | 300 por archivo |
| Tipo de archivo | Solo CSV |
| Claves de API | 2 por persona en cada organización |
| Créditos | 1 por subida. Para una tabla nueva tiene que quedar al menos un crédito. |
| Tablas | Tu plan fija cuántos archivos puede tener tu organización. |
El límite de subidas es compartido. Todas las claves de tu organización cuentan para las mismas 100. Solo cuentan las subidas que salen bien.
La ventana es móvil. No se reinicia a medianoche. Cada subida cuenta durante 24 horas desde que se hizo y después libera su hueco. Si llegas al límite, el siguiente hueco se abre 24 horas después de la subida más antigua de la ventana.
Consultar la lista de tablas, obtener una o borrarla no cuenta para el límite de subidas ni consume créditos.
Códigos de estado
| Código | Significado | Qué hacer |
|---|---|---|
200 | Ha funcionado. | Nada. |
400 | Falta algo en la petición o hay algo mal: no hay ProjectID, el archivo está vacío, no es un CSV o no está marcado como text/csv. | Revisa los campos y el archivo con Importar datos. |
401 | Falta la cabecera X-API-Key, la clave es incorrecta o está desactivada. | Revisa la cabecera y comprueba que la clave está Activa en Ajustes, en Acceso a la API. |
403 | La clave funciona, pero su propietario no tiene permiso para hacer esto. No llega a ese departamento, no puede añadir ni quitar datos en él o no puede ver esa tabla. | Pide a un administrador que revise el acceso del propietario de la clave a ese departamento. |
404 | El departamento o la tabla no existen en esta organización. | Revisa el ProjectID y el CardID. |
409 | La petición choca con el estado actual de la tabla o de la organización. La tabla todavía se está leyendo, viene de un sistema conectado (al borrar), la organización se ha quedado sin créditos o ya tiene tantos archivos como permite su plan. | Si la tabla se está leyendo, espera y vuelve a intentarlo. Para créditos o el límite de archivos del plan, habla con tu administrador. |
413 | El archivo pasa de 512 MB. | Divide el archivo o envía solo las filas que han cambiado. |
422 | Mira no ha podido leer el archivo. No tiene encabezados, tiene un encabezado que Mira no puede usar o supera las 300 columnas. | Corrige la primera fila del archivo o divídelo en archivos con menos columnas. |
429 | Tu organización ha gastado sus 100 subidas de las últimas 24 horas. | Espera a que se libere un hueco y vuelve a intentarlo. |
500 | Algo ha fallado por parte de Mira. | Vuelve a intentarlo más tarde. Si sigue pasando, contacta con soporte. |
Reintentos
Puedes reintentar sin problema un 429, un 500 o un 409 de una tabla que todavía se está leyendo. Deja pasar tiempo entre intentos, y cada vez un poco más.
No reintentes sin cambios un 400, 401, 403, 404, 413 o 422. La misma petición recibirá la misma respuesta hasta que la corrijas.