Recuperación de la cuenta
Restablezca la contraseña con el correo electrónico de la cuenta y vuelva a iniciar sesión antes de revisar el saldo, el historial o las claves API.
Resuelva un problema de cuenta o de API de NumDetect
Empiece por el código de error o el flujo de trabajo afectado, siga la comprobación recomendada y contacte con soporte solo cuando el siguiente paso documentado no lo resuelva.
Restablecer su contraseña
Referencia de solicitudes a la API
Compruebe la cabecera X-API-Key, el código del producto masivo seleccionado, el archivo subido, la respuesta de la tarea y los códigos de error publicados.
Pagos y saldo
Compare el saldo abonado, los cargos de las tareas, los métodos de pago y la regla de reembolso automático antes de abrir una consulta sobre un pago.
Guía de errores
¿Qué debe hacer ante cada error de la API?
Use conjuntamente el estado HTTP y el código de respuesta. Elimine los datos secretos antes de compartir una respuesta con soporte.
| Estado / código | Significado | Siguiente acción |
|---|---|---|
| 401 / 40100 | La clave API falta o no es válida. | Envíe X-API-Key, confirme que ha copiado la clave activa y cree una de sustitución en Configuración si la original no está disponible. |
| 402 / 40200 | La cuenta no tiene saldo suficiente para enviar esta tarea masiva. | Compruebe el precio del producto y el saldo disponible; después recargue o envíe un archivo más pequeño. |
| 429 / 42901 | La cuenta ya tiene el número máximo de tareas masivas en envío o en proceso. | Espere los segundos indicados en Retry-After y vuelva a enviar el archivo cuando termine una tarea en curso. La solicitud rechazada no se cobra. |
| 503 / 50303 | La plataforma ha alcanzado su capacidad actual de tareas masivas. | Espere los segundos indicados en Retry-After y vuelva a enviar el archivo. No se ha cobrado nada. |
| 400 / 40000 | Un archivo de tarea masiva se rechazó al subirlo (demasiado grande, vacío, con formato incorrecto, con menos de 500 líneas o sin país seleccionado), o la tarea falló mientras se preparaba el archivo: menos de 500 números válidos tras eliminar las líneas duplicadas y no válidas, más de 500.000, o demasiadas líneas que no son números válidos para el país seleccionado. | Si se rechazó la subida, no se ha cobrado nada: corrija el archivo según indique el error y vuelva a enviarlo. Si la tarea se aceptó y después falló mientras se preparaba el archivo, nunca llegó al servicio de verificación y el importe reservado se reembolsó íntegramente; el detalle de la tarea indica el motivo. |
| 409 / 40901 | La tarea no ha finalizado o su enlace de resultados aún no está disponible. | Espere a que la tarea alcance el estado success y, después, descargue su archivo de resultados desde la página de la tarea o vuelva a consultar la tarea. |
| 504 / 50400 | La tarea masiva no finalizó dentro de su tiempo límite de 300 segundos. | Vuelva a enviar el archivo completo. La tarea que superó el tiempo límite se reembolsa íntegramente. |
| 503 / 50300 | El servicio de tareas masivas no está disponible temporalmente o está en mantenimiento. | No considere el archivo como procesado. Intente enviarlo de nuevo más tarde; una tarea fallida se reembolsa. |
Antes de contactar con soporte
Incluya los datos que identifican la solicitud
Un contexto útil acorta el tiempo de investigación sin necesidad de contraseñas ni valores de claves API.
- CuentaEl correo electrónico asociado al espacio de trabajo.
- SolicitudEl ID de la tarea masiva, el código del producto seleccionado y la hora aproximada de envío.
- RespuestaEl código y el mensaje de error de la API, sin datos secretos.
Lista de comprobación para un soporte más rápido
La mayoría de los problemas de cuenta y de API se resuelven más rápido si su mensaje incluye el correo electrónico de la cuenta, el ID de la tarea masiva, el código de producto, la hora de la solicitud y el cuerpo de la respuesta con los datos sensibles ocultos.
Contacto: support@numdetect.com